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Chapter 1 


Job/Executive Interface 


When a slave job is in execution, it has full control of a 
processor in slave mede and may perform any legal slave mede 
operations, as described in the "Honeywell 600/6000 Programming 
Reference Manual". Whenever a processor leaves slave mode, the 
Executive gains control. 


A slave job may enter the Executive in various ways: it may 
request service from the Executive, it may execute an instruction. 
that faults, or scme external event (such as a physical I/0 
operation completing or timer running out) may cause the 
Executive to suspend the job. Executive entries that are not 
caused by a job are invisible to a job; when it resumes 
execution, neither its memory nor its environment will be 

changed. 


The Executive conveys information to a slave job by the following 
means: 


faults | indicating that the jod executed an 
instruction that faulted 


traps indicating that asynchronous operations have 
completed 


interrupts usually indicating that another slave joo 
| wishes to ccammunicate with this job 


This sketchy description covers the entire interface between the 
Executive and a slave job, with the exception of special 
considerations in the case of job 1 (the Slave Loader) having to 
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do with system startup). We now consider this interface in more 
detail. 


1.1 Running in Slave Mcde 


A job actually running (executing instructions) is not affected 
by the Executive, except as noted here. 


1.1.1 Base Address Register 


The base address register (BAR) limits memory references by the 
slave job. The base portion of the register is set according to 
the location of the job in main memory, and may be reset by the 
Executive at any time that the job is interrupted (is not 
actually executing instructions). The length portion is set 
according to the length of the job, and changes only when the job 
issues a MEMORY REQUEST call (on a MME fault, as described 
below). 


1.1.2 Timer Register 


The timer register is set according to the needs of the 
Executive, and may change any time the job is interrupted. The 
slave job should not therefore depend on the setting of the timer 
_ register. | 


1.1.3 Input and Output (I/O) 


An I/O activity requested by the job may proceed concurrently 
with its execution. (I/0 is requested with Executive calls, as 
described below.) A slave job should not re-use an I/O buffer 
until it has been notified by the Executive (by means of a trap) 
that the previously requested I/O has been completed on that 
buffer. 
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1.2 Job to Executive 
1.2.1 Leaving Slave Mede 


The Honeywell 600/6000 hardware provides two general methods for 
leaving slave mde: I/O interrupts and faults. I/O interrupts 
cannot be generated by a processor in slave mode. Certain types 
of faults can be generated deliberately by a slave job; other 
types are due to outside causes. The action taken by the 
Executive will depend on the type of interrupt or fault, and 
possibly on the state of the job's registers and main memory when 
the fault cccurs. 


1.2.2 Transparent Interrupts 


Certain types of interrupts are normally transparent to a slave 
job. That is, the job is restarted after the interrupt with all 
its memory and working registers (including the instruction 
counter or IC) preserved, so that it need not even be aware that 
the interrupt occurred. Included in this category are all 
connect faults, timer runout faults, and startup and shutdown 
faults. These events are not campletely undetectable by the 
Slave jcb, though. Any time a job is interrupted, including 
transparent interrupts, the Executive may take advantage of its 
opportunity to give a pending trap, slave fault, or special 
interrupt (cf. Section 1.4). It may also modify the BAR or timer 
register as previously described. 


If it is imperative to the slave job that not even these events 
cccur, it may prevent all transparent interrupts by the use of 
the inhibit bit. This hardware feature prevents any of the 
transparent interrupts fram occurring. Care should be taken, 
however, to insure that the inhibit bit is not used more than is 
absolutely necessary. Excessive use of the inhibit bit has the 
following disadvantages: 


(1) I£ the slave jcb executes inhibited cede for tco long, 
a lockup fault is generated. This fault may cccur in 
the middle of the execution of one machine instruction, 
making it impossible for the slave job to continue. 
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(2) Excessive use of the inhibit bit prevents the Executive 
from recognizing I/O interrupts as quickly as possible, 
thus slowing down the rate of I/O activity and reducing 
the total efficiency of the time-sharing system. 


1.2.3 MME Faults; Executive Calls - 


A slave job may request certain services fram the Executive by 
generating a MME (master mode entry) fault. The address field of 
the instruction causing the fault contains a code for the type of | 
call, and the job's registers and memory contain any additional 
parameters necessary. The specifications for the valid calls are 
contained in Chapter 2, "Specifications for Executive Commands”. 


Executive calls are of three types: nontrapping, trapping, and 
trapping with automatic pause. The action requested by a 
nontrapping call is performed before the slave job regains 
control. From the point of view of the slave job, its action is 
instantaneous. This action may include medification of the slave 
job's registers or memory, as described in the specifications. 
Except for such modifications, a nontrapping call is essentially 
a transparent interrupt. 


Trapping calls also function as transparent interrupts. However, 
after a trapping call has been issued and the slave job has 
regained control, the action may or may not be complete. A 
trapping call must specify a trap address in X6 at the time of 
the MME fault. When the action is complete, a trap (described in 
Section 1.4) cccurs to that address in the slave job's memory 
area. 


Trapping calls with the autcmatic pause feature share features of 
trapping and nontrapping calls. The calls are set up much like a 
trapping call; e.g. a trap address is necessary, but a pause for 

- one interrupt is assumed at the time of the call. This feature 
may make the call look much like a nentrapping call. It is 
considered good programming technique, however, to check to make 
sure that the particular trap for the current MME was returned, 
even after the autcmatic pausing type of Executive calls. 
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If a. job is in squeezed mode, or if the address field of the MME 
instruction does not specify a valid call, or if the trap address 
for a trapping call is zero, negative, or out of bounds, the MME 
fault is returned to the slave job as a slave fault (see below). 
The upper three bits of the cede for a valid Executive call are 
always 101 to reduce the chance of an undebugged jcd accidentally 
generating and issuing a valid Executive call. 


1.3 Slave Fault Vector 


The first 40 (octal) words of a slave job's memory form its slave © 
fault vector. This area is divided into two-word fault cells, 
one for each of the sixteen types of faults described in the 

_ "Honeywell 600/000 Programming Reference Manual". Same of these 
cells are used for special purposes by the Executive, while 
others are used for slave faults. The position of the individual 
cells within the slave fault vector corresponds to the hardware- 
defined locations in the master mode fault vector. They are: 


Locaticn Use 


0 initial entry Pomeseectat interrupt tally 
2 memory fault 

4 MME fault 

6 fault tag fault 

10 CRU timer runout fault 

12 command fault 

14 DRL fault 

16 leckup fault 

20 special interrupt 

22 unused (reserved) 

24 illegal procedure fault 

26 incomplete op fault 

30 unused 

32 overflow/truncation fault 
(eee divide check 

36 real time timer runout fault 
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1.3.1 Slave Fault Procedure 


When certain faults occur, they are returned to the slave job 
which generated them as slave faults. To give a slave fault, the 
Executive stores the job's IC (instruction counter) and IR 
(indicator register) registers at the time of the fault in the 
first word of the appropriate fault cell in the slave fault 
vector. The job's IC is reset to point to the second word of the 
fault cell. ; : 


If the first word of the fault cell was zero before the IC/IR 
were stored, then control is transferred to the second word of 
the fault cell. However, if it was nonzero, the job had a "dirty 
fault vector" and is aborted; that is, it is suspended, and the 
job which ran it is notified by a trap that the job had a dirty 
fault vector. The supra job then has the option of continuing or 
terminating the aborted slave job. This feature is intended to 
prevent an undebugged job from looping indefinitely due to a 
Fault in its fault processing routine. 


1.3.2 Slave Faults 


Whenever a memory, fault tag, DRL, lockup, illegal procedure 
(IPR), incomplete op (ONC), overflow/truncate, or divide check 
fault occurs, it is returned as a slave fault. Command faults 
are normally returned as slave faults. However, if the job in 
question is highly privileged (enabled) it may use a command 
fault to request an abort of the entire system (see ENABLE MME). 
This feature is to allow certain high-level slave jobs to request 
a system abort in case they detect a serious error. Command 
faults are generated when a privileged (master mode) instruction 
is executed in slave mode. 


MME faults normally indicate Executive calls. However, if the 
job generating the MME is in squeezed mede (entered by the 
Executive call SQUEEZE), if the address field of the instruction 
causing the fault does not specify a valid Executive call, or if 
the trap address specified for a trapping call is zero, negative, 
or out of bounds, the MME fault will be returned as a slave 
fault. 
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1.3.3 Simulated Slave Faults 


Two software-simulated timers are available to a slave job. A 
run-time timer is set by the Executive call SET TIMER, and a 
real-time (elapsed time) timer is set by the Executive call 
CLOCK. Both these calls are nontrapping. 


As soon as possible after either of these timers has counted down 
to zero, the timer is disabled and a slave fault is given. A 
timer runout fault is returned if the run-time timer counts to 
zero, and an execute fault is given if the real-time timer runs 
out. Either of these simulated faults may cause the job to be 
aborted for a dirty fault vector. The simulated faults are the 
only slave faults given in these fault cells; neither the 
hardware timer runout. nor execute faults are returned as slave 
faults. 


134 Spesiat Locations 


The shutdown and connect fault cells have special uses in the 
Slave fault vector. Word 0 (the first word of the shutdown fault 
cell) is the initial entry point to the job. When the job is 
first run, its IC is set to zero. Word 1 (the second word of the 
shutdown fault cell) is the job's special interrupt tally word. 
The connect fault cell is used as the special interrupt cell. 
Special interrupts are described in detail in Section 1.4. 


The parity fault cell is not currently used, and is reserved for 
future use. The startup fault cell is not used by tne Executive, 
and is available to the slave job, if it wishes to use it. 


1.3.5 Parity Faults; Execute Faults 


When a job generates a parity fault, the job is terminated. ~ The 
supra job is notified in the trap that the job was terminated due 
to an error detected by the Executive (recoverable error status 
400). In case of an execute fault, the system is aborted. An 
execute fault can be generated only py the operator at the 
processor control panel, and it is never a slave fault. 
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1.4 Executive to Job 


In addition to slave faults, the Executive also communicates with 
the slave job by using traps and special interrupts. 


1.4.1 Traps — 


A trap occurs whenever the action requested by a trapping 
executive call is completed, or when it is terminated prematurely 
by an error or invalid parameter. A trap address is specified 
when the call is issued. This address is the start of a block of 
at least four words in the slave job’s memory. When the trap is 
ready to "spring", the Executive, at its first opportunity, 
stores two words of status information in the first two words of 
this block. The job's current IC and IR are stored in the third 
word of the trap block (the return word), and its IC is reset to 
point to the fourth word. (This procedure should be compared 
with the similar procedure used to give a slave fault.) The 
fourth word should contain the beginning of the slave job's trap 
processing routine. Bits 9-17 of the first status word always 
contain a status code indicating whether the operation was 
completed successfully, and if not, why not. Other fields give 
more detailed information. A precise description of the two 
status words is given in Section 2.3. 


The following sequence of events cccurs when a slave job is 
trapped upon completion of a trapoing command: 


(1) Execution of the slave job is suspended; 

(2) Two words of status information are stored in the first 
two words of the trap block pointed to by the slave 
job's X6-register when the command was issued;. 

(3) The current value of the slave jod's instruction 
counter (IC) and indicator register (IR) are stored in 
the third word of the trap block; and 


(4) The slave job is restarted at the fourth word of the 
trap block. 
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A trap block may contain any sequence of instructions starting in 
the fourth word. This trap routine should end with an RET 
instruction whose address field points to the third word of the 
block in order to resume execution of the code interrupted by the 
trap. 


It is possible for the time between the issuance of a commard and 
the resulting trap to vary considerably. Scme traps may occur 
immediately and more than one trap may occur at once. A program 
which exits from each trap routine by a RET instruction will 
encounter all traps in the order in which they occurred; it will 
also encounter all traps before encountering any special 
interrupt which occurred at the same time as the traps. Note, 
however, that commands are not necessarily trapped in the same 
Order in which they were issued. 


1.4.2 Special Interrupts 


A special interrupt is used by the Executive to notify a job of 
some event other than the completion of a trapping Executive ~ 
call. A job will receive special interrupts only if its special 
interrupt tally word (word one) is not zero. If the word is 
zero, the job is not accepting specials. In this case, any 
special interrupts which would be given to the job are either 
discarded or bounced to a job higher in the job tree, depending 
on the origin of the special interrupt (see Section 1.4.6). 


1.4.3 Special Interrupt Stack 


Ti a job is accepting specials, the special interrupt tally word 
(word 1) contains a tally pointer to the job’s special interrupt 
stack. The tally word is typically generated by using the GMAP 
pseudo-operation TALLYD, as in: 


SPTAL:TALLYD STACK,NUMBER,2 SPECIAL INTERRUPT TALLY 


Here STACK is the symbolic location of the area in the slave job 
set aside as the special interrupt stack; NUMBER is the number of 
2-word, special interrupt data entries (special interrupt pairs) 
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which will fit in the stack, and the "2" refers to the length of 
a special interrupt pair. The last field need not be set, but 
most programmers find it convenient to do so. | 


1.4.4 Special Interrupt Procedure 


At its first opportunity after a special interrupt is generated. 
(caused), the Executive will do the following: 


(1) 


(6) 


If the job is not accepting specials (the special interrupt 
tally word is zero), the special is discarded or "bounced", 
and the procedure is complete. A special interrupt ona 
slave end of a communications file can be "bounced" to a 
higher slave end which is accepting special interrupts. 


Otherwise, any Pending roadblocks on the job are released 
(see the description of the PAUSE call in Chapter 3). 


Tf the tally field (bits 18-29) of the special interrupt 
tally word is zero, indicating that the special interrupt 
stack is full, the special interrupt is "saved" (see below), 
and the precedure terminates. 


Otherwise, if the address field (bits 0-17) of the special 
interrupt tally word points out of bounds (outside the job’s 
memory), the special is discarded, and the procedure ends. 


Two words of special interrupt data (special interrupt pair) 
are stored in the special interrupt stack. The address 
field of the tally word is incremented by two, and the tally 
field is decremented by one. 


If word 20 (the first word of the slave connect fault cell) 
is zero, a slave connect fault is simulated. If word 20 is 
nonzero, no fault takes place. No dirty fault vector aborts 
are generated. This feature can be used to prevent a slave | 
job from receiving a special interrupt (connect fault) while 
it is executing its special interrupt service routine, if 
the slave job does not clear word 20 until the end of its 
special handling routine. 
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1.4.5 Saved Special Interrupts 


If the job's special interrupt stack is full (the tally field of 
the tally word is zero) in step 3 above, the special interrupt 
pair will be saved by the Executive and given to the job as scon 
as the tally field becomes nonzero. The order of the special 
interrupts is preserved when each pair is saved. However, once a 
special interrupt pair has been saved, the special interrupt 
cannot be bounced. If the job stops accepting special interrupts 
(clears the special interrupt tally word to zero) before making ° 
roeom in the special Heer eer stack, all saved special pairs will 
be discarded. 


1.4.6 Bouncing Special Interrupts 


Only special interrupts wnich are generated by a DRIVE ccmmand at 
the master end of a communication file are bounced. The method 
by which the Executive determines which job will receive the 
special interrupt is covered in detail in Section 5.2. 


1.4.7 Special Interrupt Pair Format 


The two data words which are placed by the Executive in the 
special interrupt stack have the following format: 


0 1314 1718 35 


RSVD pIpasso) FRN 


DATA 


RSVD - Reserved for future use. These bits may contain garbage. 


TYPE - Special interrupt type (see below for a list of types). 


Pub.1059 | Page 19 


SYSTEM PROGRAMMING REFERENCE MANUAL 


FRN - Depending on the type of the special interrupt, this field 
may contain a file reference number. On specials generated 
by a DRIVE on a communication file, this field contains the 
FRN of the end of the communication file held by the job 
receiving the special. On passed file and returned file 

8 specials (types PF and RF), the FRN of the file passed or 
: returned is given here. On file closed specials (type 
FCLO), the FRN of the former cammunication file end is given 
here. 


DATA — The use of this field depends on the type of the special 
interrupt. If the special was generated by a DRIVE or CLOSE 
on a communication file, the lower half of the DATA field 
always contains the drive function data (from the lower half 
of the issuing job's A-register). Other uses of the DATA 
field are listed below. 


1.4.8 Types of Special Interrupts 


Type Mnemonic Use 

0 ST™ Set mode - used to notify the master end © 
job that a slave end job issued a set mode 
drive (see DRIVE-slave end in Section 
5.2). The lower half of DATA contains the 
mode. 


a RCF Read communication file - used to notify a 
Slave end job that the master end job 
wishes the slave to issue a READ. By 
convention the lower half of DATA contains 
the length to read. (See DRIVE-master 
end, Section 5.2.) 


2 SRS Slave issued reset - notifies the master 
end job that a slave end job issued a 
RESET STATUS on a COPY to which the master 
end job had not yet responded. (See RESET. 
STATUS, Secticn 5.2.) 


oF 2 BRK Break ~- notifies a slave end job that the 


master end job has issued a break drive. 
(See DRIVE-master end, Section 5.2.) 
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Passed File - notifies the job that a file 
has been passed to it via the PASS 
command. This special interrupt is not 
caused by the implicit PASS command in the 
RUN command. If DATA is nonzero, the 
passed file special is due to a "passback" 
from an immediate infra-job, and the lower 
half of DATA contains the FRN of the job 
file from which the file was passed. 


Returned file - notifies the job that a 
file which it passed with the return bit 
set has now been returned to it. The 
lower half of DATA contains the FRN of the 
job file to which the file being returned 
was passed. 


File closed —- notifies the job that a 
communication file of which it held an end 
has been destroyed because a CLOSE was 
issued at another end. DATA contains the 
contents of the A-register of the job 
requesting the close at the time of the 
close MME. 


Reserved for future use. 


Illegal trap address - notifies a job that 
the Executive attempted to give it a trap, 
but discovered that the trap address was 
outside the job's memory. The lower half 
of DATA contains the illegal trap address. 
This condition can arise if memory 
containing the trap block is released with 
a MEMORY REQUEST command before the trap 
occurs. 


Reserved for future use. 


Slave issued drive -— notifies the master 
end job that a slave end job issued a 
device drive. The lower half of DATA 
contains the device command (MODE). (See 
DRIVE-slave end.) 
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13 R Slave issued read -~ notifies the master 
end job that a read-type command was 
issued at a slave end. DATA contains the 
requested length. (See slave end COPY 
commands, Section 5.1.) 


14 W Slave issued write - notifies the master 
end job that a write-type command was 
issued at a slave end. DATA contains the 
requested length. (See Slave end COPY 
commands, Section 5.1.) 


aes RS Slave issued request status - notifies the 
master end job that a REQUEST STATUS was 
issued at a slave end. DATA contains the 
requested length of the status block. 


16 al Slave issued truncate - notifies the 
master end job that a TRUNCATE or SCRATCH 
command was issued at a slave end. DATA 
contains the requested truncation length 
(zero for SCRATCH). (See TRUNCATE-slave 
end only, Section 5.2.) 


big SP Slave issued set pointer - notifies the 
Master end job of a SET POINTER command 
issued at a slave end. DATA contains the 
requested pointer setting. This special 
is automatically given to a master end job 
when a COPY to or from a slave end 
specifies a starting location pointer (see 
COPY MME). 


1.4.9 Simultaneous Traps and Special Interrupts 


It is possible for more than one trap, special interrupt, or 
Slave fault to be given to a job each time that job is inter- 
rupted. In this case, the traps are linked, with the IC in the 
return word of one trap pointing to the next trap. It is thus 
important that a job be programmed so as always to return fram 
its traps, special interrupts, and slave faults by issuing a RET 
instruction to the appropriate return word. This ensures that if 
more than one trap, or if a trap and a special interrupt cccur 
simultaneously, both will be serviced by the slave job. Even if 
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the programmer believes the situation cannot occur, it is still a 
good practice to return from all traps through the return word. 
It typically simplifies program design and increases readability 
to do so. 


1.4.10 Typical Trap-Handling Code (Non-Multiprogrammed) 


The following sequence of instructions is a typical way for a 
nonmultiprogrammed slave job to handle a trapping Executive call. 
It illustrates the use of the return word.. 


EAX6 TRAP . point to trap block 
STZ TRAP+2 clear return word as flag 
_ MME (type) issue trapping Executive call 


INHIB SAVE,ON inhibit pause routine 
CHECK : SZN TRAP+2 check return word 


TNZ SPRUNG if not zero, trap has sprung 
LDX5 1,DU load pause count 
MME; PAUSE wait for one trap or interrupt 


INHIB RESTORE reset inhibit bit to normal 
TRA CHECK check flag again 

SPRUNG: LDXO TRAP pick up status word 1 
ANXO =0777,DU mask to status field 
CMPXO GOOD,DU- check for expected status 
TNZ ERROR go analyze error 


; remainder of program 


TRAP: BSS 2 two status words 
BSS 1 return word 
RET km] return immediately from trap 


This routine always waits after issuing an Executive call. Note 
that the trap routine returns immediately through the return 
word, and the main routine checks the status words. The return 
word is also used as a flag, since the Executive will not put the 
IC/IR into this word until it springs the trap. If Executive 
calls are issued in many places in a program, it is usually 
profitable in terms of memory size to place portions of the above 
routine, such as the pause loop, in a common subroutine. 
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1.4.11 Ordering of Simultaneous Traps 


The Executive will link simultaneous traps and specials in such a 
way that a job which returns through the appropriate return words 
(as all jobs normally should) will encounter first all traps and 
Simulated slave faults in the order in which they actually 
ecccurred, then the connect fault (special interrupt) if any, and 
then any slave fault other than simulated slave faults. The job 
will thus process all traps before specials. The return word in 
a slave fault cell will always point to the location where the 
fault actually occurred. 


1.4.12 Traps from Squeezed Mode 


When a job running in squeezed mede (see SQUEEZE, MME 500007 in 
Chapter 3) receives a trap, special interrupt, or slave fault, it 
is unsqueezed. The trap or interrupt takes place normally, 
except that the saved IC/IR is relative to the squeezed BAR, and 
has bit 35 (the squeeze bit) set on to indicate this fact. Note 
that the above sample trap-handling routine cannot be used by a 
job which expects to be trapped from squeezed mode, since the RET 
instruction will not "resqueeze" the job. 
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Specifications for Executive Commands 


The specifications for Executive ccmmands are divided into three 
sections: 


O brief summary of the parameters for and the status 
returns from each command; 


) detailed specifications for the nontrapping 
commands; 


e) detailed specifications for the trapping ccmmands. 


As described in Section 1.2, a slave job issues an Executive 
command by executing a MME (master mede entry) instruction with 
an address field specifying a legitimate command; execution of a 
MME instruction whose address field does not specify a legitimate 
command will result in a MME fault. (A jeb receives a MME fault 
by having the current value of its IC/IR stored in location 4 of 
its job memory and then having its IC reset to lccation 5.) 

There is one exception to this rule: if the address field of the 
MME instruction is exactly 100 (octal) greater than a valid 
trapping MME number, this is equivalent to issuing that MME 
followed immediately by a PAUSE MME with a pause count of one. 
Such MME's are called 200 series, or pausing MME's. The contents 
of the slave job's registers upon execution of a MME instruction 
specify parameters relevant to the command. 


Except in the case of a SQUEEZE or a TERMINATE command, a slave 
job will regain control at the location following a MME 
instruction unless a fault, trap, or special interrupt was » 
generated as the Executive was processing the command. In the 
case of nontrapping commands, the Executive will have completed 
processing the command by the time the slave job regains control. 
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In the case of trapping commands, the Executive may not have 

- completed processing the command; instead, execution of the 
command and of the slave job may continue in parallel, with the 
Slave job being trapped upon completion of the command. 


Numbers occurring in the specifications of this section can be of 
two types: octal and decimal. In general, numbers which can 
cccur as the contents of a register are in octal; thus, 
addresses, status returns, or special interrupt numbers are in 
octal. Numbers which do not cccur as the contents of a register 
are in decimal; for example, bit numbers and fractions of 
milliseconds are given in decimal. 
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Le ebeg 


Conmand 


Terminate 

Set Timer 
Running Tine 
Time of Day 
Dale 

Pause 

Hemory Request 
Squeeze 

Time Since Hootload 
Pure . 
Job Tiwe 

Long Pause 

Clock 

Unused 

Unused 

Enable 


“MME 


500000 
500001 
500002 
5000043 
500004 
500005 
500006 
500007 
500010 
500011 
500042 
500013 
500014 
500015 
5000 16 
500017 


xO 


Fn 
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XI 


X2 Xj 


X44 


Access 


{c/Th* 


X5 X6 


T | 
Pound 
DAR 


XT A 
Time 

Regs 

Ne 

N 
Time 
Type 


Q 


Mask 


Retura 


A = old 
bin. A 
ASCII AQ 
ASCII AQ 


X5=0 if ok 
bin. A 
X7=0 if ok 
bin. A 


A = old 


A = result 


SUNWAADD GALINDSXS YOsd SNOLEVOLATOSdS - 72 


gz ebeg 
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ee ee Ce ee Se ee ee ce Oe mate cae 


Command 


Open Scratch 

Open 

Old Erase 

Catalog 

Uncatalog 

Close 

Overlay 

Truncate 

Scratch 

Change Catalog Entry 
Erase 

Set Polnter 

Read Catalog 
Request Status 
Replace 

Execute 

Nun 

Continue 

Pass 

Alter Accesses 
Change Catalog MAX 
Old Read Cat & Open 
Provide DAs — 


'flead Catulog & Open 


Old Replace 
Copy 
Drive 
Read 

Write 
llesetl 
Tally 
Tally 
Tally 
Tally 
10g 

Duplicate 


Status 
Open 
Erase 
Replace 
Catalog 


MHE 


500100 
500101 
500102 
500103 
500104 
500105 
500106 
500107 
500110 
500111 
500112 


500113 — 


500114 


. 00115 


500116 
500117 
§00120 
§00121 
§00122 
500123 
§00124 
500125 
500126 
500127 
§00130 
500131 
500132 
500133 
§00134 
500135 
5001 36 
§00137 
500140 
500141 
500142 
500143 


FR Cat 
Fh Cat 
FR Cat 
FR Job 
FR Job 
FR Cat 
Fh Cat 


FR Cat 
Fri 
FR 
Fit 


FR 
Fr Cat 


“FR Cat 


FR Cat 
FR Cat 
Zero 
FR 


XI 


Name* 
Namne* 
Name * 


Name 
Name* 


M1" 


Nane® 
Scr 
Ser 


H3g* 


Mt* 


Mi" 
Name® 
MIs 


Mis 


Tally* 
Tally* 
Tally* 
Tally" 
M15 
Zero 


X2 


FR 


Zero 


Fit 


FR 


Zero 
Zero 
FR 
FR 
Zero 
Zero 


* tndleates polnter to word containing parameter 


X3 


Pass" 
Pass* 
Pass‘ 


Mo" 
M24 
H2* 
Pass* 
M28 


Ho" 


FR Alt Cat 
FR ALt Cat 
FR ALt Cat 
FR Alt Cat 
Zero 
Zero 


-Xy X5 
Access Pref 
Access 
Access*® Date*® 
Flag bits 
Acces3* Date* 
Trap wask Zero 
Trap mask Zero 
Limits List*® 
Limits List® 
Limits 
Access ’ Pref 
Access 
Access Cod Date 
Access Date*® 
Flag bits 
Flag bits 
Flag bits 
Flag bits 
Flag bits 
Access Last Name* 


Trap mask Last Name*® 
Trap mask Last Name* 
Access® Last Name* 
Flag bits Zero 
Access Zero 


X6 


Trap® . 


Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 


Trap*® 


Trap* 
Trap* 
,frap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap" 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap" 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap* 
Trap*® 
Trap* 


X7 A/Q 
Cat MAX 
N Slave trap 1.D. 


Slave trap 1.D. 


Comfile spectal 


Length 


N Slave trap I.). 


Polnter 
ne 
Ne 
N Slave trap T.D. 
Reg*® Time/Acc 
Reg* Time/Acc 
Time 
N* 
Cat MAX 


N# Slave trap I.D. 
N* ‘ . 
ne Slave trap JI.). 
Slave trap I.D. 
Ne 
Function 
N* 
N* 


Zero Slave trap I.D. 
Zero Slave trap I.D. 
Zero Slave trap I 
Date* 

Ne 

Zero 
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2.3 Trap Block Format 


0 8 9 17 18 : 35 
Status word 1 (Access) Status __(Access) Status _—s_ (File Reference Number) _ Reference Number) 


Status word 2 . 9g en es) or Counts) 
Return word 


x 


Trap Routine 


Access (bits 0-8 of status word 1) 
(1) On access error (status 100), gives the access bit 
needed for successrul ccmpletion of the ccmmand. 
(2) On OPEN, ALTER ACCESSES, DUPLICATE, and REPLACE, 
gives the access with the file is open or could 


have been opened. 


(3) On RUN, EXECUTE and CCNTINUE, gives termination 
access of infra job. 


(4) On DRIVE with Day's, gives record count residue. 


(5) Zero in all other cases. 
Status (bits 9-17 of status word 1) 


- Major status (see individual trapping Executive command 
descriptions). 
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2.4 Summary of Status Returns 


ALTER ACCESSES 


0 Successful 
1 ‘Partial success 
2 File closed 


SW2= Length of file 


0 Successful 

L Illegal trap protection 

2 Duplicate entry in catalog 
3. File not a scratch file 
4 
1 


File preference tco low 
3 Illegal usage or dates 


Successful | 
Illegal trap protection 
Duplicate entry in catalog 
File not found 

Protection violation 

Bad tree name 

Fetch error 

Format error 

Illegal usage and dates 
File preference too low 


t+ + “IOV & on) 
BOOK™ as 


SW2= Substatus/character count and position (if Status is 12) 


0 Successful 

1l File not cataloged 

2 Duplicate file name fourd in catalog 
3. Illegal trap bits 

13. Illegal usage and dates 
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CHANGE CATALOG MAX 


0 Successful 
1 Rejected: specified MAX is less than current ALCC 


CLOSE 


0 Successful 
6 Communication file busy 


COPY/READ/WRITE/READ CATALOG/REQUEST STATUS/READ CATALOG AND OPEN 


All words transferred 

Source file exhausted 

Destination file exhausted 

Command inaporopriate for state of communication file 
Source file pointer out of bounds 

Destination file pointer out of bounds 

Communication file busy 

Master end of cammunication file not accepting special 
interrupts | 

14 State vector full (READ CATALOG AND OPEN only) 


“SHOW Bm WN © 


SW2= Number of words transferred - number requested 


DRIVE 


Successful 

Not all data transferred 

Destination file exhausted 

Command inappropriate for state of ccmmunication file 
Communication file busy 

Other end of communication file not accepting special 
interrupts 

10. Bad DCW (Drive Type 24 only) 


SIO WN FY © 


SW2= Device status on device file drives 
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Successful 
Rejected: log already outstanding 
No leg buffer available 

Escape sequence error 


Wh FO 6 


OPEN/ERASE/REPLACE/TALLY OPEN/TALLY ERASE/TALLY REPLACE 


Successful 

Partial success 

Lockout 

File not found 

Protection violation 

Fail 

Bad tree name 

Fetch error 

Off-line file 

Rejected: specially cataloged files (device files) cannot 
be removed from catalogs (ERASE and REPLACE only) 
Format error (TALLY MME's) 


Boo aS 


= 
ho 


= Length of file or catalog MAX (zero on ERASE) or 
substatus/character count and position 
(if status is 12 on TALLY MVEs) 
OVERLAY 
1 Rejected: operation outstanding 
2 Rejected: file too long 
PASS 


0 Successful: message, if any, was read 
2 Message not read 


SW2= Number of words read - number of words in message 
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RESET STATUS 

0 Successful 

Ll Reset status already in progress 

6 Communication file busy 

7 Master end of communication file not accepting special 
interrupts 

RUN/EXECUTE /CONTINUE 


Job terminated 

CRU limit exhausted 

Job aborted 

Error in run list 

Swap error; jcb terminated 


OVUIN F © 


SW2= CRUs consumed by job 


TRUNCATE/SET POINTER/SCRATCH - 

0 Successful 

iL; Length too long or pointer out of bounds 

6 Communication file busy 

7 Master end of communication file not accepting special 


interrupts 


= Length of file - length requested (if status is l 
on TRUNCATE) 


UNCATALOG 


0 Successful 
is File not cataloged 
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Chapter 3 


Nontrapping Executive Commands 


This chapter contains detailed specifications for all nontrapping 
commands (in alphabetical order; for a list sorted by number, see 
Section 2.1). 


(28 oo; Gara ee ae a ae ea ee ae a MME 500014 
Date oo 4-4. whe a oe ee ew ew eh e)6MME 500004 
BRADLEY <3 cp. hu el ei cw Se ey ar es ee Seas MME SO0017 
TOD PAWS ah tee an i he a » 2 6 « « MME 500012 
Long Pause: 6. so% 6 i we os  & ew « MME 500013 
Memory Request ... . . « 2 2 « «© « @ MME 500006 
Pause . . 2... ..s-. be ae en » « « « MME 500005 
PQ@re: “oe ace & GS bar Ger Ok ee. Max Dee . « . MME 500011 
Running Tim@ ...... +. «2. . «© « « MME 500002 
Set Timer, cc sie. ck: ee a ek MME SOO001] - 
SQUEEZE 6 4 6 6 Ww eee we wwe we 4: CMM 500007 
Terminate ..... te oh Sas Ae. ee Wee . MME 500000 
Wameror Day 4 &: Ge oes ee. aide We 6 Re Se MME 500003 


Time Since Bootload ........ . . MME 500010 
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MME 500014: CLOCK 
A Time 


The CLCCK cammand enables a job to receive an execute fault 
(real-time timer runout fault) after a specified amount of real 
time has elapsed. If no CLOCK command is issued, or if a CLOCK 
command with an argument of zero is issued, then no real time 
timer runout fault will occur. A CLOCK command with a nonzero 
argument sets a real-time timer for the issuing job; this timer 
decrements continually, and a real time timer runout fault occurs 
wnen it reaches zero (if the issuing job happens to be road- 
blocked at this time it will be unroadblocked to receive the 
fault). After a real time timer runout fault has occurred, the 
real-time timer is disabled, and no further such fault will occur 
until a new CLOCK command is issued. 


Time is a 36-bit integer which is decremented 64 times per 
millisecond, thus accurate to the nearest 15.625 microseconds. | 


Since it is possible for a job to be swapped out of memory when 
its real-time timer reaches zero, the Executive cannot guarantee 
that a job will be restarted as soon as its real-time timer runs 
out. It can guarantee only that the job will receive an execute 
fault the first time it regains control after its real-time timer 
runs out. : 


A job receives an execute fault by having its current IC and IR 
stored in location 36 of its job memory and then having its IC 
reset to 37. 


When a CLOCK command is issued, the old value of the job's 
real-time timer is returned to the A-register. 


Note: A CLOCK command with a zero argument will not prevent an. 
execute fault from cccurring if a previously set CLOCK has 
already run down. 
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MME 500004: DATE 
No arguments 


DATE loads the ASCII date in the standard format "month/day/year" 
into the AQ-registers, e.g. 03/13/73. 
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MME 500017: ENABLE 


A Desired setting for job type bits masked by Q (bits 0-8) 

Q Mask for job type bits to set or reset (bits 0-8) 

The job type of a running job consists of two 9-bit quantities: 

the permissions allowed for the job and the permissions for which 

the job is currently enabled. These permissions are as follows: 
Bit Function 


0 Monitor permission (affects scheduling only) 


ze Core Residence permission 


2 Large State Vector permission (permits a state 
vector with more than 64 files) 


3 Special Catalog permission (allows a job to. 
specify infinite catalog MAXes, and to estimate 
the number of entries when creating a catalog) 


4 Load-Dump permission (allows preallocation of 
scratch files) 


5 Priority Scheduling (PDQ) 
6 Crash (allows slave job to abort system) 


Log (allows job to do MME LCG) 


~ 


In addition the load-dump permission suppresses quota checks 
involving catalcg MAXes, enables the PROVIDE DEVICE ADDRESSES 
command, and provides device addresses in the READ CATALOG AND 
OPEN FILES command. 


When a job is run, bits 0-8 of index register X3 on the RUN 

command are ANDed with the job type bits allowed to the issuing 
job to form the permissions allowed to the infra job. The only 
permissions which are enabled on the run are Large State Vector 


Page 38 Pub. 1059 


SYSTEM PROGRAMMING REF. MANUAL ENABLE 


permission, Priority Scheduling, Crash, and Log; all other 
permissions must be enabled by the ENABLE command. 


When an ENABLE command is issued, only those permissions 
corresponding to bits for which there are ones in the Q-register 
are affected. Each such permission is enabled if it is allowed 
for the job. When the job regains control, the corresponding bit 
in the A-register contains the current state of all permission 
bits that were affected. 
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MME 500012: JOB TIME | 
No arguments 


The total running time (CRU's) for the issuing job is loaded 
right-justified in the A-register; running times for jobs running 
below the issuing job are not included in the total. The running 
time is in timer units of 1/64 milliCRU. (See also RUNNING 
TIME.) 
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MME; 500013: LONG PAUSE 
X5 Number of traps 


LONG PAUSE is identical in effect to PAUSE. LONG PAUSE should be 
used in place of PAUSE when the issuing job dees not expect to be 
‘ restarted while residing in main memory. For example, it should 
be used when awaiting a wake-up special interrupt or when pausing 
after issuing a READ on a terminal communication file. 
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MME 500006: MEMORY REQUEST 
X5 Upper memory limit 


MEMORY REQUEST causes the BAR for the issuing job to be extended 
or compressed so as to allow a maximm valid address of N-l, 
where N is the least nonzero multiple of 1K (1024 words) greater 
. than or equal to the specified upper memory limit. The new BAR 
will be in effect when the job regains control. Memory obtained 
will be zeroed out; memory released is lost. 


If the command is successful, then X5 will be zero on return. If 
the requested memory is not available, then the amount that is 
available will be returned in X5 and another MEMORY REQUEST can 
be issued to obtain this amount. If a job has previously issued 
a PURE cammand, then any MEMORY REQUEST which would release 
memory containing pure procedure will be rejected, and the least 
amount of memory for which a memory request will succeed will be 
returned in XS. 


Tf the job's IC is no longer within the range of the new BAR 
after memory is released, then a memory fault will occur. 


The amount of memory that can be requested by a jod is limited by 
the current system limit on maximum memory length and by the 
memory limit imposed by the supra job in X4 of the RUN or 
CONTINUE command which initiated the job. 
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MME 500005: PAUSE 
X5 Number of traps 


PAUSE causes the issuing job to be roadblocked until N traps, one 
special interrupt, or one real-time timer runout fault has 
occurred. If an N greater than the number of outstanding 
trapping executive commands is specified, then an N equal to the 
number of outstanding trapping executive commands will be 
assumed. If WN is zero, the job will be roadblocked and will 
restart as soon as there is an interrupt, trap, or fault. The 
job will be restarted in a fault cell or trap block with the 
location after the PAUSE command in the return address. 
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MME 500011: PURE 


XO File reference number of source file for pure procedure 


X7 =©Points to length N 


A segment of job memory is said to contain "pure procedure" if no 
location in that segment is ever altered during the execution of 
the job. The PURE command indicates that the issuing job 
consists of pure procedure from word 100 to word N-l if X7 is 

nonzero, or that the issuing job contains no pure precedure if X7 
_ is zero. This PURE facility is designed to avoid the necessity 
Of swapping and restoring common packages of code. 


Any error in the parameters for the PURE command will cause the 
command to be rejected and X7 to be nonzero on return. The 
length N must be a multiple of 100 and must be less than or equal 
to both the current length of the issuing job and the length of 
the source file specified in X0. The file specified in XO must 
be cpen with Read permission. 


If a PURE command with a nonzero value in X7 is successful, then 
a zero will be returned in X7. On subsequent swaps of the job, 
words 100 to N-1l will not be swapped, but will be restored fram 
the source file specified in XO. This file will remain busy as 
long as the PURE command is in effect. 


If a job does not issue a PURE command, it will be assumed to 
contain no pure procedure. A job which is running with pure 
procedure can at any point declare itself impure by issuing a 
PURE cammand with X7 zero or by issuing a RESET STATUS on the 
source file for the pure procedure. Either of these two acticns 
will cause subsequent swaps to occur normally and will allow 
access to the source file for pure procedure. 


Copies to and from the pure region of a job file will be aborted 
if they occur when that job file is swapped out of main memory. 
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MME 500002: RUNNING TIME 
No arguments 


The total running time (CRU's) for the issuing job and all jobs 
running below it is loaded right-justified in the A-register. 
The running time is in timer units of 1/64 millicRU. (See also 
JOB TIME.) 
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MME 500001: SET TIMER 


A Time 


The SET TIMER command enables a job to receive a timer runout 
fault after a specified amount of processing. This timer 
decrements only when the job is actively running or doing I/O, 
and a timer runout fault occurs when this timer reaches zero or 
becemes negative. If no SET TIMER command is issued, or if a SET 
TIMER command with an argument of zero is issued, then no timer 
runout fault will cecur. A SET TIMER command with a nonzero 
argument sets a timer for the issuing job. After a timer runout 
fault has occurred, the timer is disabled, and no further timer 
runout fault will occur until a new SET TIMER command is issued. 


When a SET TIMER command is issued, the old value of the sd 
timer is ‘returned in the A-register. 


When a SET TIMER command is issued, the old value of the job's 
timer is returned in the A-register. 


A job receives a timer runcut fault by having its current IC and 
IR stored in location 10 of its job memory and then having its IC 
reset to ll. 


Page 46 | Pub. 1059 


SYSTEM PROGRAMMING REF. MANUAL SQUEEZE 


MME 500007: SQUEEZE 


X4 Points to IC/IR 


x5 BAR 


X7 = Points to registers 


The SQUEEZE cammand enables a slave job to simulate a master mede 
program by setting a pseudo base address register. SQUEEZE 
causes the BAR for the issuing job to be changed to resemble the 
BAR specified in X5, where the format of the BAR in X5 is as it 
would be if the slave job were being executed in master mede. 

For example, to squeeze a jcb so that address 2000 beccmes 0 and 
the upper memory Limit is 6000 (i.e. 6000 above the base of 
2000), the BAR in X5 would be 002006. 


After the BAR has been changed, the registers are loaded by an 
LREG instruction from the location pointed to by X7, and a RET 
instruction is executed through the specified IC/IR. If a fault, 
trap, or special interrupt cccurs while the job is in the 
squeezed mede, the BAR is unsqueezed and the fault, trap, or 
special interrupt takes place normally with bit 35 of the saved 
IC/IR in the trap or fault cell set tol. Thus a squeezed job 
can never call the Executive since all MME faults will Le 
returned to the unsqueezed job. All memory outside of the 
squeezed BAR is retained and becomes available again after the 
BAR is unsqueezed. 


If any of the parameters in a SQUEEZE command are out of range, 
then the command will be ignored and the next instruction in 
sequence will be executed. 
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MME 500000: TERMINATE 
X4 Termination access 


TERMINATE causes the termination of the issuing job ard all jobs 
running below it. All files open for the job are closed and, if 
the return bit is set in their access, returned to the supra job. 
If the supra job is accepting specials, then a special interrupt 
type 5 (returned file) is generated for each returned file. Upon 
termination, a job's remaining scratch and catalog word 
allotments are added to the corresponding allotments for the 
supra job. 


On a rormal program, the termination access specified in x4 is 
returned in bits 0-8 of status word 1 in the trap for the RUN or 
CONTINUE command which initiated the job. On a trap program 
protecting a cataloged file, the access in X4 will be the access 
permitted for the opened file. 
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MME 500003: TIME OF DAY 
No arguments 


The ASCII time of day in the standard format 
"hours :minutes:seconds" is loaded into the AQ-registers, e.g. 
20:15:45. 
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MME 500010: TIME SINCE BOCOTLOAD 
No arguments 


The time since system bootload is loaded right-justified into the > 
A-register in timer units of 1/64 millisecond. This time is not | 
_ affected by the operator's entering, the time of day. 
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Trapping Executive Commands 


This chapter contains detailed specifications for all trapping 
commands (in alphabetical order; for a list sorted by number, see 


Section 2.2). 
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500123 
500103 
500111 
500124 
500105 
500121 
500131 
500132 
500143 
500112 
500117 
500142 
500102 
500125 
500130 
500101 
500100 
500106 
500122 
500126 
500133 
500114 
500127 
500116 
500115 
500135 
500120 


500110 . 


500113 
500141 
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Tally -REPLACS: 6.6 er Wi et ac te Wel MME 500140 
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MME 500123: ALIER ACCESSES 


XO File reference number of cataloged file/catalog 
X4 Access to retain on file/catalog (bits 0-8) 


X6 Trap location 


Any accesses present on the specified file/catalog which are not 
specified in X4 are relinquished. Any accesses specified in x4 
and not present on the file/catalog will be granted if they would 
have been allowed at the time the file/catalog was opened, and if 
they do not conflict with accesses currently held by other jobs 
having the given file/catalog open. If all accesses present on 
the file/catalog are relinquished, then the file/catalog will be 
closed; i.e. its file reference number will become invalid (cf. 
CLOSE). . 


Upon completion of the command, a trap cccurs to the location 
specified in X6. Bits 0-8 of status word 1 contain the access 
bits remaining on the file/catalog. 


Status word 2 contains the current length/MAX of the file/ 
catalog. Note that this may not be the same as the length given 
when the file/catalog was originally crened if another job has 
modified the file/catalog. 


Status Returns 

0 Successful: the accesses in bits 0-8 remain and are 
the same as those requested. 

ni Partial success: the accesses in bits 0-8 remain but 
differ from those requested. This status return can 
occur if X4 contains an access bit not previously 
present or if bit 0 of X4 is 0 (is 1):and the 
file/catalog is a catalog (is a file). 


2 File closed: all accesses present were relinquished. 
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120 Busy: another operation is outstanding on the 
file/catalog. | 


200 X0 parameter error: X0 does not contain the file 
- reference number of a cataloged file/catalog. 
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MME 500103: CATALOG 


XO File reference number of catalog 

Xl Points to name of scratch file/catalog to be cataloged 
X2 File reference number of file/catalog to be cataloged 
X3. Points to password or to name of trap program 

X4 Points to access word 


X5 Points to usage information or is zero (load-dump enabled 
jobs only) 


X6 Trap location 


Tne scratch file/catalog specified in X2 is entered in the 
catalog indicated in x0 with the specified name and protected by 
the specified password or trap program. If bit 18 of the access 
word is 0, then X3 points to a password; otherwise X3 points to 
the name of a trap program. The catalog specified in x0 must be 
open with Append permission. The scratch file/catalog must not 
have the return bit set in its access word. 


If the job issuing the CATALOG MME is enabled with Load-Dump 
permission, and if XS is non-zero, then X5 points to two words of 
usage information to be placed in the cataleg entry. The first 
of these two words contains an integer in the upper half, which 
is used to set the file's days-used counter (see Chapter 9). The 
lower half of the first word contains type information or is 
zero. Type information has the following format: 


Bits Meaning 
18-20 Must be zero 


21-28 Variable information, not checked by Executive 
29-31 Must be zero 


32-35 File type 


Pub.1059 ; Page 55 


CATALOG 4 — TRAPPING EXECUTIVE CCMMANDS 


There is currently only one allowable file type, which is 
"off-line" (14 octal). Files to be cataloged with this type must 
have no physical storage asscciated with them (zero length; no 
device addresses). 


The upper half of the second word contains a coded date used to 
initialize the file's Date Last Used attribute. The lower half 
of the same word contains a coded date used to set the file's 
Date Last Modified attribute. If the job is not Load-Dump 
enabled, or if X5 is zero, then the days-used count is set to 
zero, and the date-last-used and date-last-medified are set to 
the current date. A coded date contains in bits 0-8 the binary 
representation of the year (modulo 100), in bits 9-12 the binary 
representation of the month (JAN=1, DEC=12),. and in bits 13-17 
the binary representation of the day of the month. 


The Executive sets bit 0 of the access word to zero if the 
file/catalog being cataloged is a file and to one if it isa 
catalog. (For further details on the catalog access word consult 
the publication "File Access amd Protsction”".) The catalog 
structure is described in more detail in Chapter 9. 


A jeb which successfully catalogs a scratch file/catalog has its 
scratch word allotment incremented by the length of the file or 
of the catalog header. At the same time its catalog word 
allotment is decremented by this quantity and also by the length 
of the entry created in the catalog. 


Upon completion of the command a trap occurs to the location 
specified in X6. 


Status Returns 
0 Successful. 
i; Illegal trap protection request: a master trap 


protection bit which is not allowed to the issuing job 
has been specified. 
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13 


40 


60 


100 


120 
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An entry with the given name is already in the catalog. 


The file/catalog is already cataloged; i.e. it is nota 
scratch file/catalog. 


The file/catalog specified in X2 has a preference of 0, 


1, 2, or 4, and may be cataloged only in a core 
catalog. 


Illegal usage and dates: illegal type or extraneous 
bits specified in usage word pointed to by XS. 


Quotas exceeded: either 

(1) Cataloging the file/catalog would cause the 
destination catalcg's allocated storage to exceed 
the permissible MAX; or 

(2) The length of the file or of the catalog header to 
be cataloged exceeds the ai remaining catalog 
word allotment. 


Cut of storage, for one of three reasons: 


(1) The catalog is full: 
(a) It already has 4095 entries; or 
(b) It is not possible to aprend to the catalog 
since it either is a main-memory catalog or 
is already allocated in twelve fragments; or 
(2) The Executive could not allocate sufficient 
storage for a required expansion of the catalog; 
or 
(3) The Executive's table of opened files is full. 
Access error: the catalog is not open with Append 
permission; bits 0~8 of status word 1 contain the 
missing permission bit. 


Busy: another cammand is outstanding on either the 
catalog or the file/catalog to be cataloged. 
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XO parameter error: X0 is zero or does not contain the 
file reference number of the catalog. 


Xl parameter error: the pointer to the name is out of 
bounds. 


X2 parameter error; either: 


(1) . X2 does not contain the file reference number of a 
scratch file/catalog, | 


(2) The scratch file/catalog had the return bit set in 
its access word (see the description of the 
EXECUTE command), or 


(3) X5 points to usage information specifying a file 
type of off-line but the file has device addresses 
allocated (see Chapter 9). 


X4 parameter error: either the pointer to the access 
word is out of bounds or the access word contains 
extraneous bits. 


X5 parameter error: the job is enabled with load-dump 
permission, and the pointer to the coded dates is out 
of bounds. 


Recoverable error: an error occurred in reading the 
catalog. 


Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500111: CHANGE CATALOG ENTRY 


XO File reference number of cataloged file 
XL Points to new name or is zero 

X3. Points to new password or is zero 

X4 Points to new accesses or is zero 


X5 Points to new usage information or is zero (load-dump 
enabled jobs only) 


X6 Trap locaticn 


The CCE MME attempts to alter information in the catalog entry 
(file control block) of a cataloged file. x0 contains the file 
reference number of the file whose entry is to be changed. The 
file must be cataloged, and the job must be able to obtain Read, 
Write, and Append permission on the file using the ALTER ACCESS 
MME. 


Catalog entries are described in some detail in Chapter 9. 


If XO centains a valid file reference number, the Executive 
attempts the following changes to the catalog entry of the file: 


(1) If£ Xl is nenZero ard points to two valid memory 
locations, the two words pointed to will beccme the new 
name of the file. If the first nine-bit character is 
not a null, all lowercase alphabetic characters will be 
Mapped to uppercase. 


(2) I£ X3 is nonzero ard points to two valid memory | 
locations, the two words pointed to will become the new | 
password or slave-trap program name. If the first 
nine-bit character is not a null, all lowercase 

- alphabetic characters will be mapped to uppercase. 


(3) I£,X4 is nonzero and points to a valid memory lccation, 
the word in that location will beccme the access word 
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(4) 


for the file. I£ this word contains trap bits which 
the issuing job does not possess, the MME is rejected 
with a status of 3. The file/catalog status of an 


entry cannot be changed, and any attempt to do so will 
be ignored. 


If a job is Load-Dump enabled, and if X5 is nonzero ard 
points to two valid memory locations, those two words 
contain the new usage information for the file. The 
format of these two words is exactly the same as those 
pointed to by X5 of the CATALOG MME. 


Upon completion of the command, a trap occurs. to the location 
specified by X6. 


Status Returns 


wo 
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Successful: the catalog entry for the file reflects 
all changes indicated. 


File not cataloged: the file specified by x0 is a 
scratch file or has been uncataloged. 


Duplicate file name: the catalog in which this file is 
located contains an entry whose name is equivalent to 
the one pointed to by Xl. 


Illegal trap bits: the access word pointed to by X4 
specifies trap bits which the job dees not possess. 


Illegal usage and dates: illegal type or extraneous 
bits specified in usage word pointed to by XS. Hither: 


(1) The date last used was zero, 
(2) The file is not a regular cataloged file/catalog, 
(3) The file was passed with the return bit set (see 


the description of the EXECUTE command) and is 
being changed to an off-line file, or 
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(4) The variable information was specified in bits 
21-28 of the first word pointed to by X5, but the 
file is not being changed to an off-line file. 


100 Access error: job could not have altered access for 
RWA. 

200 XO parameter error: X0 dces not contain the file 
reference number of a cataloged file or catalog. This 
status is also returned if XO specifies a file which 
has a nonzero length or wnich has storage allocated to 
it and X5 points to a type word specifying a type of 
"off-line". 

220 Xl parameter error: pointer is cut of bounds. 

260 X3 parameter error: pointer is out of bounds. 


300 X4 parameter error: X4 is out of bounds or points to 
access word containing unrecognized bits. 


320 XS parameter error: cointer is out of bounds. 


400 Recoverable error: an error cccurred in reading the 
catalog. 


420 Unrecoverable error: the file was being uncataloged 
during the MME. 
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MME 500124: CHANGE CATALOG MAX 


XO File reference number of catalog 
X6 - Trap location 


A New MAX for catalog 


XO contains the file reference number of a catalog for which the 
job would be able to obtain Read, Write, and Append accesses via 
the ALTER ACCESS MME. The previous MAX for the specified catalog 
is replaced by the new value, which becomes the new maximm 
number of words which can be cataloged in that catalog. A 
negative MAX sets this maximum to infinity and can be specified 
only by those jobs enabled with the special Catalog permission. 
Likewise only such jobs may set the MAX for a catalog below its 
current ALOC. 


ALOC's and MAX's are described in Chapter 9. 


Upon completion of the command a trap occurs to the location 
specified in X6. 


Status Returns 


0 Successful. 


1 Unsuccessful: the specified MAX is less than the 
current ALOC for the catalog and the job is not enabled 
with the Special Catalog permission. 


40 Quotas exceeded: the catalog is cataleged elsewhere 
and the new MAX would cause the supra catalog's storage 
(ALOC) to exceed its MAX. 


100 Access error: the maximum accesses which the job could 
obtain on the catalog do not include Read, Write, and 
Append. : 


120 Busy: another operation is outstanding on the catalog. 
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140 
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400 


420 
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A-register parameter error: the job is not enabled 
with the Special Cataleg permission and is specifying a 
negative MAX. 


XO parameter error: xX0 does not contain the file 
reference number of the catalog. 


Recoverable error: an error cccurred in reading or 
writing the catalog or the one in which it is 
cataloged. 


Unrecoverable error: information in the catalceg or in 
the one in which it is cataloged has been destroyed. 
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MME 500105: CLOSE. 


XO File reference number of file/catalog to close 


X6 Trap location 


A Special word for canminication file 


The command CLOSE closes the file/catalog and invalidates the 
file reference number assigned to it. 


If the return bit is set in the access word of the file/catalog, 
then the file/catalog is returned to the job which passed it, 
generating a special interrupt number 5 (returned file). If it 
is a scratch file/catalog and the return bit is not set in its 
access word, then it disappears from the system and the job's 
scratch storage allotment is incremented by the length of the 
file or of the catalog header which disappeared. 


If the master end of a cammunication file is closed, or ifa 
Slave end to which the communication file was passed without the 
return bit is closed, then a special interrupt of type 6 (file 
closed) is generated at all other ends of the file. The data 
word of this special interrupt is equal to the contents of the 
A-register of the closing job at the time of the CLCSE MME. The 
file reference number at the end issuing the CLOSE becomes 
invalid, and the file reference numbers at all other ends became 
invalid parameters for all MME's except CLOSE and RESET STATUS. 


If a suspended job file is closed, then that job and all jobs 
below it are terminated (see the description of the EXECUTE 
command for a description of suspended jobs). All files open for 
these jobs are closed; if the return bit is set in the access 
word of a file/catalog open for any job being terminated then the 
file/catalog will be passed back up to the terminating job's 
supra job. If the supra job is accepting specials, each returned 
file will generate a special interrupt number 5 (returned file). 
The job issuing the CLOSE will also have its scratch and catalog 
word allotments incremented by the remaining allotments for the 
jobs being terminated. Status word 2 on the trap of the CLOSE 
will contain the CRU usage accumulated by the closed job file and 
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all jcbs which ran below it, in units of 1/64 millicRU. (See the 
description of the TERMINATE command.) 


If a terminated job file is closed, no special action is taken, 
but status word 2 will contain the CRU usage for that job and all 
jobs which ran below it. 


Upon completion of the command a trap cccurs to the location 
specified in X6. 


Status Returns 


0 Successful. 


6 Communication file busy: the file is a communication 
file on which an operation is outstanding. 


120 Busy: either a command is outstanding on the | 
file/catalog or the file/catalog is passed to another 
job. 


200 XO parameter error: either x0 is zero or it dees not 
contain a valid file reference number. 


Pub. 1059 Page 65 


CONTINUE 4 — TRAPPING EXECUTIVE COMMANDS 


MME 500121: CONTINUE 


X0 File reference number of job file 
X4. New memory limits or zero 
X6 Trap location 


A Additional CRU limit for job 


This MME restarts and runs jobs which have been suspended 
because: | 


(1) The job exceeded its allotted CRU usage; 
(2) The job encountered a fault vector abort; or 


(3) The job was stopped by a RESET STATUS. 


The A-register will contain the amount of additional CRUs that 
the jcb can consume (in 1/64 milliCRU). A negative value 
indicates there is no limit on CRU usage. Any jobs which were 
running below the supra job and whose execution was suspended as 
a result of the supra job's being suspended, are also restarted. 


If X4 is nonzero, then the maximum amount of main memory that the 
spawned job can request is reset to the minimum of the amount 
specified in X4 and the amount allowed to the spawning job. If 
X4 is zero, this limit remains the same as it was before. 


A trap occurs to the location specified in X6 whenever the 
additional CRUs allotted to the job are exceeded, when status are 
reset on the job file, or when the job terminates or aborts. 
Status word 2 on this trap contains the total CRU usage 
accumulated by the spawned job and any jobs which ran below it. 


If the trap occurred because the job was suspended (for the 
reasons listed above), the job may be restarted by another 
CONTINUE command. If the job terminated, however, another 
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CONTINUE may not be issued. A program can recognize a terminated 
file by its length, which is always zero, (this can be verified 
by a REQUEST STATUS command), whereas the length of a suspended 
job is never zero. 


“Status Returns 


300 


400 
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Job terminated sucessfully; bits 0-8 of status word 1 


contain the access bits specified by the spawned a2 in 
the TERMINATE ccmmand. 


Time limit exceeded; the job may be continued. 

Job aborted for receiving a fault whose return word was 
nonzero. All jobs running below this one are suspended 
also. The job may be continued. 

Job terminated due to an error on while swapoing out. 


Status was reset; the job may be continued. 


Busy: another operation is outstarding on the job 
file. 


XO parameter error: X0 does not contain the file 
reference number of a nonterminated job file. 


X4 parameter error: the new memory limits specified 
are less than the current length of the job file. 


Recoverable error: this is a catch all status 
indicating an abnormal termination. It may indicate 
any of the following: 

(1) I/O error swapping in the job 


(2) Parity error while the job is running 


(3) Unsuccessful overlay MME 


(4) Jcb has somehow grown larger than slave memory 


(5) Job's state vector has grown larger than 3K and. 
job has not enabled large state vector permission. 
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MME 500131: COPY 


XO File reference number of source file 


Xl Points to pointer to starting location Ml in source file or 
pointer to logical record number of device file 


X2 File reference number of destination file. 


X3 Points to pointer to starting location M2 in destination 
file or pointer to logical record number of device file 


X4 Plag bits 
X60 6‘ Trap location 


X7 =Points to number of words N to copy 


N contiguous words are copied from the source file (starting at 
word ML) to the destination file (starting at word M2). All 
other words of the destination file are unaffected. 


Read permission is required on the source file; write permission © 
is: necessary on the destination file if the copy will alter any 
existing data in the destination file, and append permission is 
required if the copy will make the destination file longer. In 
any case, the destination pointer M2 must not be greater than the 
destination file's length. 


During the actual copy, if the end of the source file is reached, 
an end-of-file condition occurs and data transmission stops. If 
any of the words transferred to the destination file are outside 
the range of that file, the file is extended if it is open with 

Append permission. Otherwise, an end-of-file condition occurs 

and data transmission stops. Upon completion of the copy, a trap 
occurs to the location specified in X6. 


If XO (X2) is zero, then the source (destination) file is assumed 
to be the issuing job's memory with Read and Write permission 
set. If Xl (X3) is zero, then the current position of the source 
(destination) file's read/write pointer is used. This option 
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cannot be used with core, which has no implicit read/write 
pointer. Upon completion of a copy, the read/write pointers for 
both files are updated to point to the word following the last 
word accessed. 


A COPY issued at a slave end of a communication file will 
generate a special interrupt number 11 (slave end issued READ) or 
12 (slave end issued WRITE) at the master end. The secord word 
of the interrupt will contain the length of the copy. (See COPY 
command in Chapter 5.) No data will be transferred until the 
master end issues a corresponding COPY. If the communication 
file is busy, either because another end has an operation 
outstanding on it, or because another end has reserved it, the 
slave end issuing the COPY command will be trapped with a status 
of 6. If the job at the master end of a communication file is 
not accepting special interrupts when a slave end issues a COPY, 
then that slave end will be trapped with a status of 7. 


The slave end will be trapped with a 20 status (status reset) if 
the master end chooses to abort the copy by issuing a RESET 
STATUS command on the communication file. 


The master end job will receive a slave issued SET POINTER 
special interrupt if: 


(1) A Jeb issues a COPY to the slave end of a communication 
file, and X3 is nonzero; or 


(2). A job issues a COPY from the slave end of a ccmmunica- 
tion file, and Xl is nonzero. 


The pointer specified by the slave erd is placed in the secord 
word of the special interrupt pair. This special interrupt will 
immediately precede the slave issued READ or slave issued WRITE 
special received by the master end job. 


The flag bits in 4 are divided into two 9-bit fields. Bits 0-8 
are flags referring to the source file (specified in X0). Bits 
9-17 refer to the destination file (specified in x2). They have 
the following meanings: 
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Bit Function 


0(9) If the source (destination) file. is a master 
cammunication file, trap the corresponding slave 
end only if a nonzero status return cccurs or if 
this bit is zero. This bit must be zero if the 
source (destination) file is not a master 
cammunication file. 


1(10) If the source (destination) is a slave communica- 
tion file, reserve that file for this end if this 
bit is 1. Release any prior reservation by this 
end if this bit is zero. 


If the source (destination) file is opened in 
shared mode, do not allow any copy-type operations 
to be initiated on this file after this copy 
operation completes, except for operations by this 
job on this file reference number. 


Tf the file is neither a communication file nor a 
shared file, this bit must be Zero. 


2(12) 
. Reserved for future use. These bits must 
em. be zero. | 

8 (17) 


A COPY in which both the source and destination files are 
communication files is not allowed. If the source (destination) 
file in a COPY is a device file, then the destination (source) 
file must be a core file, the issuing job's core, or a communica- 
tion file whose other end is being copied to or from a core file 
or some job's core. If the source (destination) file is opened 
in shared mede, then the destination (scurce) must be the issuing 
job's memory. , 


Upon initiation of a COPY into a scratch (cataloged) file which 
is open with append permission, the job's scratch (catalog) word 
allotment is decremented by the amount by which the destination 
file may be extended. At the completion of the COPY, the job's 
scratch (catalog) word allotment is incremented py the number of 
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words charged to this allotment but not appended to the 
destination file. 


If the status return in status word 1 is not between 100 and 360 
on completion of the COPY, then status word 2 contains the 
difference between the number of words transferred and the number 
of words requested (i.e. it contains minus the number of words 
not tranferred). If the status in word 1 is between 100 and 360, 
then status word 2 is zero. If either the source or the , 
destination file is a device file, then the lower half of status 
word 1 contains the status return fram that device. 


Status Returns 


0 Successful: all words were transferred. 


ni Source file exhausted: more words were requested but 
could not be transferred. 


2 Destination file exhausted: scme words in the source 
File were not transferred since the destination file 
was full and was not open with Append permission... 

3 Command inappropriate: a COPY issued at the master end 
of a communication file does not match a corresponding 
operation outstanding at a slave end. 

4 The source file pointer is out of bounds: either, 

(1) The pointer was initially out of bounds; 


(2) A MEMORY REQUEST released job storage involved in 
the copy; or 


(3) An attempt was made to copy from the pure region 
of a job file which was swapped out of main 
memory. 

5 The destination file pointer is out of bounds: either, 


(1) The pointer was initially out of bounds; 


Pub. 1059 in Page 71 


COPY 


20 


40 


60 


100 


120 


200 


220 


240 


Page 72 


4 — TRAPPING EXECUTIVE COMMANDS. 


(2) A MEMORY REQUEST released job storage involved in 
the copy; or 


(3) An attempt was made to copy into the pure region 
of a job file which was swapped out of main 
Memory. 


The communication file at whose slave end this cammand 


was issued is busy (a) because another erd has an 
operation outstanding, or (b) because another end has 
reserved the communication file. 


The master end of the communication file at whose slave 
end this command was issued is not accepting special 
interrupts. 


Status was reset on the COPY. 


Quotas exceeded: it is possible for the COPY to exceed 
the job’s remaining scratch or catalog word allotment; 
no words were transferred. 


Out of storage: the Executive could not allocate 
sufficient storage for a required extension of the 
destination file. 


Access error: either the source file is not open with 
Read permission, or the destination file is not open 
with the necessary Write or Append permission. Bits 
0-8 of status word 1 contain the missing permission 
bits. 


Busy: another command is outstanding on either the 
source or the destination file. 


XO parameter error: X0 dees not contain the file 
reference number of a file, or X2 specifies a shared 
file and XO is not zero. 


Xl parameter error: Xl points to an out-of-bounds 
location, or both XO and Xl are Zero. 


X2 parameter error: either X2 dces not contain the 
file reference number of a file, both source and 
destination files are communication files, or X0 
specifies a shared file and X2 is not zero. 
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X3 parameter error: X3 points to an out-of—bounds 
location or both X2 and X3 are Zero. 


X4 parameter error: an invalid flag bit is set in xX4. 
X7 parameter error: X7 points out of bounds. 


Recoverable error: an error cccurred during trans- 
mission of data. The lower half of status word l 
contains the status from the device which generated the 
error. See Chapter 6 for a description of device 
statuses. This status can cccur if a device file is 


.being accessed via a communications file and the job 


has swapred out of main memory. 
Unrecoverable error: a COPY was attempted between a 


device file and another file not appropriate for device 
file copies. 
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MME 500132: DRIVE 


XO File reference number of file 

Xl Pointer to Data Control Words (Drive with DCW's only) 
X4 Flag bits | 

X6 Trap location 

X7 = =Number of DCW's (Drive with DCW's only) 


A Drive type (AU) and function or data (AL) 


The DRIVE command may be issued only on a communication file or 
on a device file. Drives on communication files generate special. 
interrupt at some other emd of the file. Drives on device files 
cause the drive function to be applied to the device. Upon 
completion of the command, a trap occurs to the location 
specified in X6. 


Drive types valid at the slave end of a communication file are 0 
(set communication file mode) ard 12 (single device action). 
These drives generate special interrupt numbers 0 and 12, 
respectively, at the master end of the communication file. The 
lower half of status word 2 in such a a interrupts contains 
the drive data from AL. 


Valid drive types at the master end of a communication file are l 
(read communication file) and 3 (break), which generate the 
corresponding special interrupt: 


(1) At the lowest slave end accepting special interrupts, 
providing no slave end has reserved the communication 
file; or 


(2) At the slave end which has reserved the communication 
file. 
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Drive type 3 will generate a special interrupt number 3 at the 
lowest slave end which is accepting specials, which has eXecute 
permission on the communication file, and which is not lower than 
the slave end to which the file is.reserved (if it is indeed . 
reserved to a slave end). 


If a DRIVE is issued on the slave end of a communication file 
that is busy due to the action of another end, the DRIVE is 
rejected with a status of 6. If on any communication file drive 
the end to which the special interrupt should be given is not 
accepting special interrupts, the DRIVE is trapped with a status 
Of. 7. 


The flag bits in X4 have the following meanings: 


Bit Function 
_ 0 Must be zero. 
a Must be zero unless X0 contains the file reference 
: number of a slave cammunication file. In that 
case, the communication file will be reserved for 


the end issuing the drive if this bit is 1. Any 
prior reservation by this end is released if this 
bit is zero. 


2-17 Must be zero. 


Following is a list of drive functions wnich may be issued on the 
slave end of a terminal ccmmunication file. The drive tyre 
(contained in AU) for these drives is zero. 


000000 Set line-by-line input mede 

Q00001 Set file building input mede 

000002 Set file building mede for paper tape 
000003 Set direct input mode 

000004 Set carmand input mode 

000005 Set cammand mede for paper tape 
000007 Answer back drum request 

000020 Set full-—duplex output mode 

000021 Set nalf-duplex output mode 
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000022 Set direct output mode 

000023 Reset direct output mode 

000024 Set Friden output mode 

000025 Reset Friden output mode 

000026 Stop output 

001000 Output any currently pending warning 


There are two valid drive types for device files: 12 (single 
device action) and 24 (drive with DCW's). A drive of type 12 
applies the function specified in AL to the device before the 
drive is trapped. The valid function cedes are listed in Chapter 
6s 


A drive type of 24 also applies the function in AL to the 
specified device and then traps. The valid function codes are 
listed in Chapter 6. 


A list of Data Control Words (DCW's) pointed to by Xl must Le 
supplied for this drive. See Chapter 6 for a description of 
CCWs. 


Status word 2 on a completed single action device drive contains . 
the status return from the device. The format of this status 
return is as follows: 


Bits Meaning 


0 ICM sync bit (normally on). 

1-5 Major status. | 

30-35 Record count residue (number of records requested 
minus the number transferred). 

6-11 Minor status. 

12-17 Queue address bits; the operation was terminated 


by an initiate interrupt if between 20 and 37 ard 
by a terminate interrupt if between 40 and 57. 


18-23 ICM status (0 is good) 
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24-29 Return code from Executive I/O routine. 
Status Returns 


0 Successful. 
L Incomplete data transfer; no error. 


2 End-of-file encountered on tape or last batch button 
depressed on card reader. 


3 Recoverable error; details in major and minor status. 

4 Unrecoverable error; do not reissue ccmmand. 

5 Operation on device was timed out. 
If a DRIVE with DCW's fails with a bad DCW status, status word 2 
contains the number of the faulty DCW. If a drive with DCWs 
fails with a status of 1, 2 or 400, status word 2 contains the 
DCW residue of the last DCW accessed. Bits 0-5 of status word 1 
of a DCW DRIVE contain the record count residue if the device was 


accessed. Bits 18~35 of status word l contain the first 18 bits 
of the device status return. 


For further information concerning DRIVE functions and status 
returns for device DRIVEs, see Chapter 6, “Device Files”. 


Except as noted above for device drives, status word 2 in the 
trap of a DRIVE command is zero. 


Status Returns 
0 Successful. 


L Not all data was transferred on a Drive with DCWs, but 
data transferred was correct. 


2 End-of-file condition detected on device file drive. 
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Command inappropriate: the DRIVE was issued at the 
master end of a communication file while a slave end of 
that file had an operation outstanding. 


Communication file busy: the DRIVE was issued on the 
Slave end of a communication file which is busy, either 
because another end has an operation outstanding on it, 
or because another end has reserved it. 


The end of the communication file which was to have 
received the special interrupt was not accepting 
special interrupts. 


Bad DCW: DCW points to nonexistent address, invalid 
action code, or superfluous bits were found in DCW. 


Status was reset on a drive. 

Busy: .another cperation is outstanding on the file. 

A register parameter error: the specified drive type 
is not valid. On DRIVE with DcwW's this may occur 
because of an insufficient DCW camplement. 

XO parameter error: X0 does not contain the file 
reference number of a communication file or of a device 
file. 

Xl parameter error: DCW list pointer out of bounds. 


X4 parameter error: X4 contains invalid flag bits. 


X7 parameter error: the number of DCW's is zero or 
indicates DCW's past the boundary of main memory. 


Recoverable error: an error occurred on a device file 
drive; the major and minor status bits in status word 1 
identify the error. 


Unrecoverable error: the device drive function 
specified is not valid. 
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MME 500143: DUPLICATE 


XO File reference number to duplicate 

XL Reserved for future use (must be zero) 

X2 Reserved for future use (must be zero) 

X3 Reserved for future use (must be Zero) 

X4 Accesses to request for new file reference number 
X5 Reserved for future use (must be zero) 

x6 Trap location 

X7 = Reserved for future use (must be zero) 


The DUPLICATE ccmmand creates another file reference number for 
the file/catalog specified with X0. 


Register X0 must contain the file reference number of a cataloged 
file/catalog. Any accesses not specified in X4 will not be 
available with the new file reference number. Accesses specified 
in X4 will be granted if they would be allowed on an ALTER 
ACCESSES and they do not conflict with accesses which this and 
other jobs have on the file. 


On completion of the command a trap cccurs to the location 
specified in X6. If the status return is less than 2 then the 
lower half of status word 1 contains the new file reference 
number. 


Status Returns 


0 Successful: the accesses in bits 0-8 are available on 
the new file reference number and are the same as those 
requested. 
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Partial success: the accesses in bits 0-8 are 
available on the new file reference number but differ 
from those requested. 


Lockout: due to usage conflicts the file cannot be 
open with another file reference number 


Inappropriate: X0 does not contain the file reference 
of a cataloged file/catalog 


Quotas exceeded: the job has filled its allotted state 
vector Length 


Busy: another command is outstanding on the file/ 


catalog specified in x0 


XO parameter error: X0 does not contain the file 
reference number of a file/catalog 
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MME 500112: ERASE 


XO ©File reference number of initial catalog to search 
Xl Points to name of file/catalog to erase 

X2 Reserved for future use (must be zero) 

X3 Points to password (or is zero) 


x4 (bits 0-8) must be zero 
(bits 9-17) trap bit mask 


x5 Reserved for future use (must be zero) 
X6 Trap location 
X7 Number of entries in treename (if zero, then 1 is assumed) 


AQ Slave trap identification words 


The ERASE command attempts to open the specified file/catalog 
(with the specified password if X3 is nonzero and witncut a 
password otherwise) in the specified catalog with Read, Write, 
and Append permissions. If it is successful it then destroys the 
file/catalog together with its catalog entry. 


Catalog quota checks are suspended for the ERASE ccmmard; hence, 
it can be used to destroy files in catalogs whose quotas have 
been exceeded. Conflict checks with accesses currently held by 
other jobs having the given file/catalog open are suspended for 
all accesses except Write. An ERASE command may therefore be 
used to destroy a file/catalog which is open, provided that it is 
not open with Write permission. With the exception of this and 
the catalog quota check, an ERASE command is identical in effect © 
to the sequence of commands OPEN, UNCATALCG, and CLOSE. 


Upon completion of the carmand a trap occurs to the lecation 
specified in X6. 
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Status Returns 
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Successful: the file/catalog was erased. 


Lockout: the file/catalog is currently in use with 
Write permission. 


Not found: Search permission was available on same 
intermediate catalog and the next file/catalog was not 
found in it. 


Protection violation: Search permission was available 
on the next-to-last catalog and the password specified 
for the file/catalcog was wrong. 


Fail: Search permission was available on the 
next-to-last catalog, and one of the Read, Write, or 
Append permissions was not available. 


Bad tree name: Search permission was available on same 
intermediate catalog and the next entry in the treename 
was not the last entry, but was the name of a file 
rather than a catalog. 


Fetch error: either — 

(1) An error of type 3, 4, 5, or 6 occurred and Search 
permission was not available on the catalog in 
which the search was being performed; or 

(2) Search permission was not available on the (N-l)st 
catalog and Fetch permission was not available on 
the file/catalog. 


ERASE disallowed: the named file/catalog is a device 
file. 


Busy: another command is outstanding on the catalog. 


XO parameter error: XO dees not contain the file 
reference number of a catalog. 


X1 parameter error: the pointer to the name is out of 
bounds. 
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X2 Parameter error: X2 is nonzero. 


X3 parameter error: the pointer to the password is out 
of bounds. 


X4 parameter error: bits 0-8 of X4 are ncnzero. 
XS parameter error: XS is nonzero. 


X7 parameter error: X7 is greater than 10 (maximum of 
10 names in the list of entries pointed to by Xl). 


Recoverable error: an error occurred in reading the 
catalog. 


Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500117: EXECUTE 


XO File reference number of source file | 
XL Length of scratch area to append to source file. 
X3 Job type (bits 0-8) 

X4 Maximum amount of memory job is allowed 

X5 Pointer to run list 

X6 Trap location 


X7 = Pointer: to eight-word block containing registers 


A Job CRU limit (in 1/64 millicRo) 


Q Job access mask 


The source file, which must be open with execute permission, is 
run as a new job with the CRU limit specified and with the files 
in the run list open for it. The new job is started at location 
zero with the specified registers and with all indicators off 
except the zero indicator, which is on. 


A job file is created for the new job, and its file reference 
number is returned in bits 18-35 of status word 1 of the trap 
block specified by X6 before execution of the creating job is 
resumed. The job file remains open until closed by the creating 
job. 


The amount of memory with which the new or spawned job is run is 
determined as follows: the length of the source file is rounded . 
up to a multiple of 1K (1024 words) and to this length is 
appended a scratch area of the length specified in Xl, also 
rounded up to a multiple of 1K. The spawned job can issue a 
MEMORY REQUEST to change the size of its memory, but can request 
no more memory than the lesser of the amount specified in xX4 and 
the amount of memory allowed to the job which issued the EXECUTE 
command. 
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Bits 0-8 of X3 are ANDed with the job type bits allowed to the 
job issuing the EXECUTE to form the permissions allowed to the 
spawned job. (See the description of the ENABLE command for a 
list of these permissions.) At the time the job is run, the 
permissions for which it is enabled are Large State Vector, 
Priority Scheduling, Crash, and Log. The spawned job must enable 
itself for any other allowable permissions by issuing an ENABLE 
command. 


Run List (Pointed to by X5) 


SEES 
— Spawner's ID ~ 
| Catalog Quota | 
| Scratch Quota | 
——————$ $+ 
oo a 


+... passed files ...+ 


The run list pointed to by X5 must be at least five words long 
and be terminated by a zero. The maximum length of a run list is 
32 words. If no zero word is encountered in the first 32 words, 
the Executive will stop scanning the run list. The first two 
words in the run list are the identifying words for the spawned 
job. These words can be read by the spawned job and all jobs 
which are run below it by issuing a REQUEST STATUS on file 
reference number 0. 


The third and fourth words of the run list limit the number of 
words that the spawned jod can append to cataloged and scratch 
files. These limits should be less than the limits of the supra 
job. If they are not, the Executive will substitute the supra 
job's limits. The limits actually passed to the spawned jod will 


Pub.1059 Page 85 


EXECUTE 4 — TRAPPING EXECUTIVE CCMMANDS 


be indicated to the supra job in the third and fourth words of 
the run list. If any file operation issued by the spawned job 
results in a situation where these limits are exceeded, then that 
operation will be trapped with a status return of 40 (quotas - 
exceeded). The catalog and scratch word allotments for the 
spawned job are subtracted from the corresponding allotments for 
the spawning job. Upon termination of the spawned job, the job 
which ran it will have its catalog and scratch word allotments 
incremented by the allotments remaining for the terminating job. 


The remainder of the run list contains a list of File/catalogs to 
be passed to the new job. A zero word indicates the end of the 
list. Each word in the list contains the following information: 


Passed File Word 


ape Fae 


0 89 17 18 35 


Bits © Meanin 

0-8 Access to pass with file 

9-17 Preference (for created file) 
18~35 | File reference number or zero 


The nth word in this list causes the file/catalog with the file 
reference number specified in bits 18-35 to be passed to the new 
job with the access specified in bits 0-8. In the new job this 
file/catalog will have file reference number n. 


(1) If the file reference number in bits 18-35 is 0, then a 
File will be created and passed to the new job. 
(2) If bit 1 of the access is 0, then a scratch file will 


be created with the preference specified in bits 9-17 
and passed. 
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(3) If bit 1 of the access is 1, then a communication file 
will be created and its slave end passed. 


(4) I£ the return bit (bit 2) is set in the access word for 
a created scratch file or if a communication file is 
Created, then the file reference number of the file for 
the creating job will be returned in bits 18-35 of the 
run list entry before execution of the job is resumed. 


Job files, master ends of communication files, and 
File/catalogs which have been passed already or which are 
currently busy cannot be passed to the new job. The file> 
reference number of a file/catalog which has been passed without 
the return bit set becomes invalid. File/catalogs other than 
Slave ends of communication files which are passed with the 
return bits set become busy until they are closed and returned by 
the spawned job. A file/catalog which has the return bit set in 
its access word must be passed with the return bit set. A 
scratch file/catalog which is passed without the return bit set 
automatically has all accesses set for the new job. As opposed 
to files passed by the PASS ccmmand, no messages accompany files 
passed through the run list. The current setting of the 
read/write pointer for a file/catalog is preserved when it is 
passed. 


Job Access Mask (Q register) 


oc 


0 17 =19 20 28 29 «35 
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The job access mask of the issuing job is ANDed with the job 
access mask specified in the Q-register to form the access mask 
for the new job. The bits in this access mask have the following 
significance: 


Bits Meaning 


0-19 Unused 

20-28 Permission bits for master trap program (see 
CATALOG) 

29=—35 Preferences to allow when creating scratch 


file/catalogs (see OPEN SCRATCH) 


The job file for a successfully spawned job remains busy until a 
trap occurs to the location specified in X6. The lower half of 
status word 1 contains the file reference number of the job file. 
Status word 2 contains the total running time (in CRU's) 
accumulated by the spawned job and any joos which ran below it. 
The trap cecurs whenever the CRUs allotted to the spawned job is” 
exceeded, status is reset.on the job file, or the job terminates 
or is aborted. 


If the trap occurred because the CRU limit was exceeded, status 
was reset, or the job aborted, the job is suspended, and its 
execution may be continued by using a CONTINUE ccmmard. If, 
however, the job terminated, either successfully, or because of 
an error on swap-out, or because of a recoverable error, a 
CONTINUE may not be issued. If a suspended job file is closed 
rather than being continued, status word 2 on the trap of the 
CLCSE command will contain the total CRU usage (in 1/64 milliCRU) 
of the job. This will reflect any additional time charged to the 
job by the Executive in the process of terminating it and all 
jobs below it. If a terminated job file is closed, the CRU usage 
is returned in the trap of the CLOSE. (See CLOSE.) A terminated 
job file can always be recognized by the fact that its length 
(available through a REQUEST STATUS command) is always zero, 
while a suspended jcb never has zero length. 
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Status Returns 


0 Job terminated successfully: bits 0-8 of status word 1 
contain the access bits specified by the spawned job in the 
TERMINATE command. 


1 Time limit exceeded: the job may be continued. 

2 Job aborted: the jod received a fault whose return word was 
nonzero. All jobs running below this one are suspended 
also. The job may be continued. 

2 Run list error: the job was not run. The lower half of 
status word 2 contains a pointer to the entry in the run 


list in error. The upper half of status word 2 contains cne 
of the following error types: 


0 Oversize run list: a maximum of twenty files may 
be passed. 


60 System out of storage: the Executive's table of 
opened files is full. 


120 Busy: the file reference number in the pass list 
is that of the source file for the RUN command. 


240 Bad file reference number in bits 18-35: either 
(1) The file reference number is invalid; 


(2) It is the file reference number of a busy, 
passed, or master cammunication file; or 


(3) It is zero and the job issuing the RON 
command has a job access mask which does not 
permit it to specify a preference for 
creating a scratch file. 


300 Bad access in bits 0-8: either 


(1) Extraneous bits are set in the access word; 
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100 


120 


140 


200 
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(2) The return bit is not set in the access. word, 
though the file/cataleg was passed to the 
issuing job with the return bit set; 

(3) Bit 0, the catalog bit, is zero (is one) and 
the file/catalog being passed is a catalog 
(is a file); 

(4) No accesses are present in bits 5-8; 


(5) The catalog bit is one and bits 18-35 are 
Zero; OF 


(6) The return bit is set in the access word for 
the creation of a communication file. 


Job terminated due to an error on a Swap-out. 
Status was reset: the job may be continued. 


Quotas exceeded: A job possessing no master trap bits 
may have at most one run/execute outstanding. 


Out of storage: either 

(1) The Executive's table of running jobs is full; 

(2) The length of the new job including the aprended 
scratch area, if any, exceeds the system limit on 


job length; or 


(3) The depth of the joo in the job tree is too great 
to allow it to issue EXECUTE commands. 


Access error: the source file is not open with eXecute 
permission; bits 0-8 of status word 1 contain the 
missing permission bit. 


Busy: another cperation is outstanding on the source 
file. . 


A register Darameter error: the time specified for the 
new jod to run is zero. 


XO parameter error: 
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(1) x0 is zero; 


(2) XO is not the file reference number of a scratch 
or cataloged file; 


(3) XO is the file reference number of a file whose 
length is zero or greater than 2718. 


X4 parameter error: the initial size of the new job, 
including the aprended scratch area, if any, exceeds 
the limits specified. 


X5 parameter error: the pointer to the run list is out 
of bounds. 


x7 parameter error: the pointer to the registers is 
out of bounds. 


Recoverable error: this is a catch all status 
indicating an abnormal termination. It may indicate 
any of the following: 

(1) I/0 error swapping in the job 

(2) Parity error while the job is running 

(3) Unsuccessful overlay MME 


(4) Job has scmehow grown larger than slave memory 


(5) Job's state vector has grown larger than 3K and 
job has not enabled large state vector permission. 
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MME 500142: LOG 


XO - ‘Reserved for future use (must be zero) 

XL Pointer to pointer to memory location ML 

X2 Reserved for future use (must be Zero) 

X3 Reserved for future use (must be zero) 

X4 Flag bits 

X5 Reserved for future use (must be zero) 

X6 Trap location 

X7 = Pointer to number of words N to copy 

The ASCII message which begins at location Ml and extends for N 


words is entered into the system log. The flag bits in x4 
perform the following functions: 


Bit Meaning 

0 Ring the console alarm if the system legging device is 
a console. 

it Suppress log device output and direct this entry to the 


system log file only, if one exists. 


Bit zero in X4 has no effect if the logging device is not a 
console, or if:no legging device output occurs. Bit one in x4 
has no effect if the Executive has no current log file at the 
time of the MME. A job which does not possess the Log enable bit 
may not issue this MME. A job may have at most one LOG MME 
outstanding at a given time. Upon completion of the MME, a trap 
cccurs to the location specified by X6. If the logging device is 
accessed, the lower half of status word 1 contains the physical 
device status. 
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Status Returns 


400 


440 


Successful. 


LOG MME outstanding. An erroneous attempt has been made to 
perform two log MME's concurrently. 


Buffer not available. This is a recoverable error 


signifying a temporary scarcity of main memory. 


ESCAPE sequence error. The ASCII message contains too many 
exclamation points, question marks, or control characters 
other than carriage return, line feed, or horizontal tab. 
XO parameter error: xX0 is not zero. 


Xl parametar error: Xl is out of bounds or points to an > 
invalid core pointer. 


X2 parameter error: X2 is not Zero. 

X3 parameter error: X3 is not Zero. 

X4 parameter error: X4 contains undefined flag bits. 

X5 parameter error: X5 is not zero. 

X7 parameter error: X7 is out of bourds, points to a number 
N which is larger than thirty words (120 characters) or 
zero, or specifies a length which exceeds the available 


memory. 


Recoverable error: a recoverable I/O error has cccurred to 
the log device. 


Not enabled: the job is not enabled with Log permission. 
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MME 500102: OLD ERASE 


X0 File reference number of catalog to search 

X1 Points to name of file/catalog to erase 

X3. Points to password (or is zero) 

x6 Trap location 

AQ Slave trap idoneieiexsion words 

The OLD ERASE command is exactly like the ERASE command, except 
an X4 of zero is assumed (but not checked) — which means that 


only one filename can be specified — and the unused registers do 
not. need to be zero. 


Status Returns 


0 Successful: the file/catalog was erased. 


2 Leckout: the file/catalog is currently in. use with 
Write permission. 


3 The desired file/catalog was not found in the searched 
catalog. 


4 Protection violation: the specified password was 
wrong. 


S Fail: one of the Read, Write, or Append permissions 
was not allowed. 


ll OLD ERASE disallowed: the named file/catalog is a 
device file. 


100 Access error: the catalog is not open with Search 
permission; bits 0-8 of status word 1 contain the 
missing permission bit. 


120 Busy: another cammand is outstanding on the catalog. 
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XO parameter error: x0 dces not contain the file 
reference number of a catalog. 


Xl parameter error: the pointer to the name is out of 
bounds. 


X3 parameter error: the pointer to the password is out 
of bourds. 


Recoverable error: an error occurred in reading the 
catalog. . 


Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500125: OLD READ CATALOG AND OPEN FILES 


XO File reference number of catalog 

Xl Points to number Ml of first entry in the catalog to copy 
X3 Points to pointer to memory location M2 

X4 Access for OPEN (bits 0-8) 

XS Coded date 

X6 Trap location 

X7 =6©Points to number of words N to copy 

_ AQ Slave trap identification words 

‘The OLD READ CATALOG AND OPEN FILES command is like the READ 
CATALOG AND OPEN FILES camnmand with two exceptions. Register X2 
is not reserved for future use. Register X5 does not point to. 
coded dates, but contains a coded date last medified. Informa- 


tion for files other than catalogs is provided if the file's date 
last modified is not less than the ceded date given in X5. 


This is equivalent to a READ CATALOG AND OPEN FILES command with 
X5 pointing to a word with zero in the upper half and the coded 
date last modified in the lower. 
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MME 500130: OLD REPLACE 


XO 


AQ 


' File reference number of catalog 


Points to name of file/catalog to replace 
File reference number of scratch file/catalog 
Points to password or is zero 

Trap location 


Slave trap identification words 


The OLD REPLACE command is exactly like the REPLACE ccamand, 
except an X4 of zero is assumed (but not checked) -~ which means 
that. only one filename can be specified — and the unused 
registers do not need to be Zero. 


Status Returns 


0 Successful: the file/catalog was replaced and is new 
open with the accesses in bits 0-8. 


1 Partial success: the file/catalog was replaced and is 
now open with the accesses in bits 0-8. Append 
permission has been masked off since the searched 
catalog's MAX is exceeded. 


2 Lockout: the cataloged file/catalog is currently in 
use with Write permission. 


3 The desired file/catalog was not found in the searched 
catalog. 


4 Protection violation: the specified password was 
wrong. 


5 Unsuccessful: one of the Read, Write, or Append 
permissions was not allowed. 
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OLD REPLACE disallowed: the named file/catalcg is a 
device file. 


Quotas exceeded: either 


(1) The length of the scratch file or catalog header 
exceeds the job's remaining catalog word 
allotment; or 


(2) The specified catalog's MAX is exceeded, and the 
length of the scratch file or MAX of the scratch 
catalog is greater than the length or MAX of the 
file/catalog to be replaced. 


Out of storage: either 
(1) The Executive's table of opened files is full, or 


(2) A new entry had to be made in the catalog for the 
replacement and 


(a) The catalog already had 4095 entries; or 


(b) The Executive could not allocate sufficient 
storage for a required extension of the 
catalog; or 


(c) It is not possible to append to the catalog 
Since it either is a main-memory catalog or 
is already allocated in twelve fragments. 


Access error: the initial catalog to search is not 
open with Search permission; bits 0-8 of status word 1 


contain the missing permission bit. 


Busy: another operation is outstanding on either the 
catalog or the scratch file/catalcog. 


XO parameter error: XO does not contain the file © 
reference number of a catalog. | 


Xl parameter error: Xl points out of bounds. 


X2 parameter error: either 
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(1) &2 dees not contain the file reference number of a 
scratch file/catalog; 


(2) The scratch file/catalog was passed to the issuing 
job with the return bit set; 


(3) The type of the scratch file/catalog does not 
match the type of the file/catalog it is to 
replace; or 


(4) The file/catalog has a preference of 0, l, 2, or 4 
and may only replace a file in a core catalog (a 
catalog of preference 0). 


260 X3 parameter error: the pointer to the cassword is out 
of bounds. 


400 Recoverable error: an error cccurred in reading the 
catalog. 


420 Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500101: OPEN 


XO File reference number of initial catalog to search (0->:MFD) 
Xl Points to treename of file/catalog to open 


X3 Points to password of a a to open (if bit 1 of x4 
is l) 


X4. Access desired on file/catalog (bits 0-8); 
Trap bit mask (bits 9-17) 


X6 Trap location 
87 ~~ =Number of entries N in treename (if bit 4 of x4 is 1) 


AQ Slave trap identification words 


The specified file (denoted by a list of filenames wnich form a 
"treename") is located in the file system and opened. A file 
reference number is returned, which is used on all subsequent 
operations on the file. 


The treename pointed to by Xl begins with a list of catalog names 
and ends with.the name of the file/catalog to open. If the fetch 
bit (bit 4) of X4 is 1, then X7 specifies the number of entries N 
in the treename, which must be between one and ten. If bit 4 of 
x4 is 0, then N is taken to be one. 


Note that if the fetch bit (bit 4 or bit 22) is not on in the 
access word of a file/catalog, then it can be opened only if a 
job can cpen the catalog in which it is located with search 
permission. If, however, the fetch bit is on in the access word 
of a file/catalog, then a job need not be able to open the 
catalog(s) above it in the catalog structure. The file/catalog 
may be opened by specifying its position in the catalog structure 
and passing only the access checks associated with the file/ 
catalog itself. Thus files and catalogs may be protected either 
collectively by the accesses permitted for catalogs at higher 
levels in the catalog structure, or individually by their own 
accesses. Also note that whenever the master trap program is run 
during an open, the accesses of the issuing job will be limited 


Page 100 Pub. 1059 


SYSTEM PROGRAMMING REF. MANUAL OPEN 


by the trap bit mask in bits 9-17 of x4. In this case, for any 
bit cn the mask, the corresponding trap protection bit cannot Le 
passed to the cpened file, regardless of the accesses with which 
the issuing job is running. 


The procedure for opening the file/cataleg specified by the 
treename is as follows. The initial catalog specified by x0 is 
searched for the catalog specified by the first entry of the 
treename; if XO is zero, then the Master File Directory is 
searched. As each succeeding catalog in the treename is found, 
it is searched for the catalog specified by the next entry of the 
treename. Finally the (N-1)st catalog is searched for the 
file/catalog specified by the Nth entry of the tree name. 


For each intermediace catalog in the tree name (i.e. catalogs l 
to N-lL), the accesses available are determined in one of two 
manners: 


(1) I£ Search permission was available on the previous catalog, 
then the accesses available on the current catalog are those 
allowed without a password (bits 3-8 of the current 
catalog's access word), or those returned by the Executive 
trap program if the catalog is so protected. If Owner 
permission was available on the previous catalog and the 
current catalog is not protected by the Executive trap 
program or the Executive trap is successfully run, then all 
accesses are allowed on the current catalcg. 


(2) If Search permission was not available on the previous 
cataleg, then the accesses available on the current catalog 
without a password (bits 3-8 of the current catalog's access 
word), or those returned by the Executive trap program if 

. the catalog is so protected, are examined for the presence 
of the fetch bit (bit 4). If the fetch bit is on, then 
accesses are granted on the current catalog just as if 
Search permission had been available on the previous 
catalog. If the fetch bit is not on, then no accesses are 
granted on the current catalog. 


When the (N-1)st cataleg is searched for the file/catalog 
specified by the last entry of the tree name, the accesses 
available qm that file are determined as follows. If this 
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file/catalog is found, bit 1 of x4 is 1, and file/catalog is not 
protected by a trap program, then the password pointed to by x3 
is checked against the password protecting the file/catalog. If 
the password check succeeds or is not made, then the accesses 
allowed on the file/catalog are determined in one of two manners: 


(1) If Search permission was available on the (N-1)st catalog, 
then the access bits requested in X4 are ANDed with the. 
access bits allowed by the access word of the file/catalog 
(bits 3-8 of the access word if the file/catalog is being 
opened without password, bits 21-26 if the file/catalog is 
being opened with a password, or the access bits returned by 
the trap program protecting the file/catalog). If Owner 
permission was available on the (N-l1)st catalog, and the 
file/cataleg is not protected by a trap program and is 
protected by a successfully run master trap, then all 
requested accesses are allowed on the file/catalog. In 
addition, if the opening job possesses all master trap bits 
and has a zero mask in X4 in addition to Owner permission on 
the (N-1)st catalog, then any slave trap program is bypassed 
and all permissions are granted on the file/catalog. 


(2). If Search permission was not available on the (N-l)st | 
cataleg, and the fetch bit is on in the access word of the 
file/catalog, that is, 


(a) Bit 4 of the access word if the file/catalog is 
being opened without a password; 


(b) Bit 22 if the file/catalog is being opened with a 
password; or 


_ (c) Bit 4 of the accesses returned by the trap Pree 
protecting the file/catalog; 


then the accesses allowed on the file/catalcog are the same as if 
Search permission had been available on the (N-l)st catalog. If 
Search permission was not available on the (N-l)st catalog and 
the fetch bit is not on m in the access word of the file/catalog, 
then no accesses are allowed on the file/catalog. 
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Next the access bits allowed are checked for use conflicts with 
accesses currently held by other jops whose file/catalcg is open. 
Access bits that are in conflict are masked off. In addition, 
Append permission is masked off if the MAX of the (N-l1)st catalog 
has been exceeded. All access bits are masked off if the 
allocated storage for the (N-1)st catalog exceeds twice its 
permissible MAX. Finally, bit 0 of the access is set to 1 if the 
file/catalog is a catalog. The file/catalog is opened if any | 
accesses remain in bits 5-8. 


On completion of the command, a trap cccurs to the location 
specified in X6. If the file/catalog was opened successfully, 
then the access bits obtained. are returned in bits 0-8 of status 
word 1, the new file reference number of the opened file/catalog 
in bits 18-35 of status word 1, and the length of the opened file 
or the MAX of the opened catalog in status word 2. If the. 
command was unsuccessful, then the uprer half of status word 1 
contains the reason. for the failure, and the lcwer half contains 
Zero. 


In addition to the access bits returned in status word 1 of the 
trap, nine user access bits can be obtained by issuing a REQUEST 
STATUS. These user access bits are obtained from bits 27-35 of 
the cpened file/catalog's access word if the file/catalog was 
opened with a password. If the file/catalcg was opened without a 
password or if it was protected by a trap program, the user 
access bits are obtained from bits 9-17 of the access word. 


The read/write pointer of the opened file/catalog is initialized 
to zero. 


Status Returns . 


0 Successful: the accesses in bits 0-8 were obtained and 
are the same as those requested. 


ZL Partial success: the accesses in bits 0-8 were 
obtained but differ from those requested. This status 
return can cccur if bit 0 of the requested access is 0 
(is 1) and the opened file/catalog is a catalog (is a 
file). | | 
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Lockout: due to usage conflicts, none of the requested 
accesses were available on the file/catalog. 


Not found: Search permission was available on some 
intermediate catalog and the next file/catalog was not 
found in it.: 


Protection violation: Search permission was available 


on the (N-1)st catalog and the ere specified for 
the file/catalog was wrong. 


Fail: Search permission was available on the (N-1)st 


_ Catalog and none of the requested accesses were 


available on the file/catalog. This can occur if the 


_ file/catalog is slave-trapped and the slave trap. 


program is not correctly cataloged. 


Bad tree name: Search permission was available on some 
intermediate catalog and the next entry in the treename. 
was not the last entry, but was the | name of a file 
rather than a catalog. 


Fetch error: either 

(1) An error of type 3, 4, 5, or 6 occurred and Search 
permission was’ not availadle on the catalog in 
which the search was being performed; or 

(2) Search permission was not available on the (N-1)st 
catalog and Fetch permission was not availaole on 
the file/catalog. : 

Cff-line file. 


Quotas exceeded: either 


(1) The job has exceeded its allotted state vector 


length; or. 
(2) Alleccated Sesesee for the (N-l1)st catalog is over 


twice the permissible MAX, and files must be 
erased from this catalog before any can be opened. 
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Qut of storage: the Executive's table of opened files 
1s £011. 


Access error: the initial catalog to search is not 
open with Search permission; bits 0-8 of status word 1 
contain the missing permission bit. 


Busy: another command is outstanding on the catalog 
specified in X0. 


XO parameter error: X0 dces not contain the file 
reference number of a catalog. 


Xl parameter error: the pointer to the tree name is 
out of bounds. 


X3 parameter error: bit 1 of X4 is 1 and the pointer 
to the password is out of bounds. 


X7 parameter error: bit 4 of X4 is 1, and X7 contains 
a zero or a number of file names greater than ten. 


-Recoverable error: an error cccurred in reading an 


intermediate catalog. 


Unrecoverable error: information in an intermediate 
catalog has been destroyed. | 
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MME 500100: OPEN SCRATCH 


X4 File/catalog flag (bit 0) 
X5 Preference (for files only) 
X6 Trap location 


A. Catalog MAX or preallocation length N (Load-Dump enabled 
jebs only) 


Q Estimated number of catalog entries (special catalog enabled. 
jobs only) 


A scratch file is opened if bit 0 of X4 is zero. Otherwise, a 
scratch catalog is opened. The scratch file/catalcg is created 
with all permissions (i.e. Read, Write, Append, aa Aaa ea 
and Owner). 


Preference is an integer between 1 and 7 which specifies the » 
class of storage preferred for the file being created. Classes 
of storage are as follows: © . 


Swap files 

System files (BASIC, ALGOL, ...) or 
monitor scratch files 

Catalogs 

Scratch files 

Special data base 

Saved files 

Permanent data base 


Nh 


“~—YO’) Wp Ww 


The preferences which the issuing job can assign are limited by 
bits 29-35 in its job access mask (set by the supra job on a RUN 
or EXECUTES command). A jcb can assign a preference n only if bit 
28+tn in its access mask is 1. Attempts to assign other 
preferences will result in the Executive's rounding the 
preference to a higher number if possible and to a lower one 
otherwise. All catalogs will be assigned a preference of 3 by 
the Executive. Assigned preferences continue to hold when a 
scratch file/catalog is cataloged. 
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The OPEN SCRATCH command normally does not preallocate any 
storage for a scratch file; such storage is allocated as needed 
whenever information is appended to the file. Where N is 
specified in the A-register, an OPEN SCRATCH command issued by a 
job enabled with the Load-Dump permission will cause N words to 
be preallocated for the scratch file. This preallocation is 
designed to alleviate excessive fragmentation of storage. 


The parameters in the A- and Q-registers are normally applicable 
only when a scratch catalog is being created. In that case MAX 
sets the maximum number of words which can ccecur in that catalog 
and in all files and catalogs cataloged beneath it. A negative 
MAX sets this maximum to infinity and can be specified only by 
those jobs enabled with the Special Catalog permission. 

- Likewise, only such jobs can specify an estimated number of 
catalog entries in Q. This estimate is used as a guide by the 
Executive in allocating storage for the catalog so as to optimize 
disk accesses for catalog searches. The Executive will determine 
this initially allocated length for catalogs created by all 
nonenabled jcbs. 


_ When a scratch catalog is opened, the job's remaining scratch 
word allotment is decremented by the length of the scratch 
catalog header. 


A trap to the lecation specified in X6 cccurs upon completion of 
the command. If the command is successful, status word 1 
contains the file reference number of the created file in its 
lewer half. 
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Status Returns 


0 Successful. 
40 _ Quotas exceeded: either 


(1). The job has exceeded its alloted state vector 
length; 


(2) The job access mask for the job does not permit it 


to specify any DESeer ance for a scratch file/ 
ae or 


(3) The charge for writing a scratch catalog header — 
exceeds the job's remaining scratch word 
allotment. . 


60 Out of storage: sufficient storage is not available 


for the scratch catalog header or for preallocating a 
scratch file. 


140 A~register parameter error: either 
(1) The job is not auipied with the Special Catalog . 
permission and is specifying a negative MAX for a 
scratch catalog; or 


(2) The job is enabled with the load—dump- permission ; 
and register A is negative. 


160 Q-register Parameter error: the job is enabled with 
the Special Catalog permission and is specifying more 
than 4095 entries for a scratch catalog. 


400 Recoverable error: an error cccurred in writing the 
scratch catalog header. 
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MME 500106: OVERLAY 


XO File reference number of scurce file 
X4 Flags for operation 
X6 Trap location 


‘X7~~=6-Pointer to registers 


The source file specified by X0, which must be open with eXecute 
permission, is copied over the issuing jcb's memory. The job's 
registers are loaded from the area specified by X7, which must 
begin at a multiple of eight words. | 


If bit 0 of X4 is 1 at the time of the overlay, the source file 
will be closed when the overlay is complete. If bit 0 of X4 is 
0, the source file will remain open ard unchanged. 


If all parameters are correct and there are no errors during the 
copy cperation, the job is restarted at location zero with the 
registers pointed to by X7, and with the zero indicator on. 


If an error is detected before the copy operation begins, the 
issuing job is trapped to the trap location specified by X6 with 
one of the statuses listed below. 


If an error occurs after initiation of the copy, the issuing job 
is aborted and the supra job's RUN or CONTINUE command is trapred 
with a status of 400 (recoverable I/O error). 


Status Returns 


L Overlay rejected: The overlay has been rejected 
because the job has another trapping Executive command 
outstanding. 
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Overlay rejected: file is bigger than current 
allocated memory. 


Access error: The file specified by x0 is not open 
with eXecute permission. | 


XO parameter error: X0 is zero, does not contain a 
valid file reference number, or contains the file 
reference number of a device, job, or cammunication 
file. 


-&4 parameter error: X4 contains illegal flag bits. 


X7 parameter error: The pointer in X7 is cut of bounds © 
or is not a multiple of 8. 
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MME 500122: PASS 


XO File reference number of job file or zero 


XL Points to a location which points to the starting location 
Ml of message 


X2 File reference number of file/catalog to pass or zero 
X4 Access to pass with file/catalog 

XS Preference (for created files) 

X6 Trap location 


X7 ~=6 Points to the length N of the message or is zero 


The file/catalog is passed down to the job specified in x0, 
generating a special interrupt number 4 (passed file) if that job 
is accepting special interrupts. This-special interrupt gives 
the new file reference number of the file/catalcog in the lower 
half of the first interrupt word and the length of the file or 
MAX of the catalog in the second interrupt word. The new file 
reference number is not necessarily equal to the one for the job 
passing the file/catalog. 


If X7 is nonzero and points to a nonzero word, then the message 
specified can be read by the job to which the file/catalog is 
passed. This is accomplished by issuing a REQUEST STATUS as the 
first file operation on that file/catalog. If X7 is zero or 
points to a zero word, then no message acccmpanies the 
file/catalog cn the pass. A trap cccurs to the location 
specified in X6 when the message, if any, is read or when any 
‘other file operation is initiated on the passed file. Hence, the 
message should not be altered until the trap cccurs. 


If X2 is zero then the Executive will create and pass a scratch 
file, or create a communication file and pass its slave end, 
depending on whether bit 1 of the access word specified in x4 is 
Qorl. The file reference number of the created file is 
returned in the lower half of status word 1 in the trap for the 
PASS (unless. the file created was a scratch file and the return 
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bit was mot set in the access in X4). No message can be passed 
with a communication file. 


T£ x0 is zero, then the file/catalog will be passed upward to the 
immediate supra job. Currently, this feature is implemented for 
created comminication files only. 


Job files, master ends of camnmunication files, and file/catalogs 
which have already been passed cannot be passed to an infra job. 
The file reference number of a file/catalog which is passed 
without the return bit (bit 2) set in its access word becomes 
invalid. With the exception of slave ends of communication 
files, file/catalogs which are passed with the return bit set» 
become busy until they are closed and returned by the infra job. 
A file/catalog which has been passed to the job issuing the PASS 
with the return bit set must be passed to an infra job with the 
return bit set. A scratch file/catalog which is passed without 
the return bit set autcmatically has all accesses set for the 
infra job. The current setting of the read/write pointer for a 
file/catalog is preserved when it is passed. 


Status Returns 


0 Successful: the message, if any, was read. 
2 Successful: a message existed but was not read. 


60 System out of storage: the Executive's table of opened 
files is full. 


120 Busy: another operation is outstanding on the 
' file/catalog to be passed. 


200 XO parameter error: xX0 does not contain the file 
reference number of a nonterminated job file. 


220 Xl parameter error: Xl points out of bounds. 
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240 X2 parameter error: either 


(1) 


(2) 


(3) 


X2 does not contain a valid file reference number; 


It contains the file reference number of a passed 
file/catalog or of the master end of a communica- 
tion file; or 


It is zero and the job access mask for the issuing 
job does not permit it to specify a preference for 
creating a scratch file. 


300 X4 parameter error: either 


(1) 
(2) 


(7) 


Extraneous bits are set in the access word; 

The return bit is not set in the access word 
though the file/catalog was passed to the issuing 
job with the return bit set; 

Bit 0, the catalog bit, is 0 (is 1) and the 
file/catalog being passed is a catalog (is a 

file) ; | 

No accesses are present in bits 5-8; 

The catalog bit is on and X2 is Zero; 


The return bit is set and so is the bit to 
indicate the creation of a communication file; or 


“XO is zero and X4 dees not specify the creation orf 


a cammunication file 


360 X7 parameter error: X7 points out of bounds. 
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MME 500126: PROVIDE DEVICE ADDRESSES 


XO File reference number of file 
X3. Points to pointer to memory location M2 
X56 Trap location 


X7 . Points to length N of buffer 


The PROVIDE DEVICE ADDRESSES command is a privileged command 
which can be issued by jobs enabled for the Load-Dump permission. 
Nonenabled jobs which attempt to issue it will receive a status 
of 440 fault. The command causes the device address list for the. 
specified file to be copied into the buffer of length N starting 
at memory location M2; no device addresses will be copied if the 
whole list does not fit into this buffer. Upon completion of the - 
command, a trap occurs to the location specified in x6. If the 
command was successful, status word 2 contains the number of 
device addresses for the file. 


This command cannot be used to provide device addresses for a 
catalog. Enabled jobs desiring the device addresses for a 
catalog can obtain them by issuing a READ CATALOG AND OPEN FILES 
command .. 


Status Returns 


0 Successful. 
120 Busy: another operation is outstanding on the file. 


200 XO parameter error: X0 does not contain the file 
reference number of a scratch or cataloged file. 


~260 x3 parameter error: X3 points out of bounds or points 
to an out-of-bounds pointer. 


360 X7 parameter error: either X7 points out of bounds or 


the list of device addresses for the file will not fit 
into the specified buffer. ) 
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440 Not enabled: the job is not enabled with Load-Dump 
permission. 
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MME 500133: READ 


XO File reference number of source file 

X3. Points to pointer to memory location M2 
X4 Flag bits 

X6 Trap location 


X7 =Points to number of words N to read 


N words are read from the source file starting at the current | 
position of that file's read/write pointer into the issuing job's 
memory starting at location M2. Read permission is required on 
the source file. If the source file is exhausted or if the end 
of the issuing job's storage is reached, an end-of-file condition 
cccurs and transmission of data stops. Upon completion of the 
COPY a trap occurs to the location specified in X6. 


Zero is an illegal parameter for X0 or X3. Upon completion of 
the copy, the read/write pointer for the source file is updated 
to point to the word beyond the last one read. 


A READ issued at the slave end of a communication file will 
generate a special interrupt number 11 (slave end issued READ) at 
the master end. The second interrupt word will contain the 
length of the READ. No data will be transferred until the master 
end issues a corresponding WRITE or COPY. (See the description 
of cammunication files in Chapter 5.) If the communication file 
is busy, either because another end has an operation outstanding 
on it, or because another end has reserved it, the slave end 
issuing the READ command will be trapped with a status of 6. 

the job at the master end of a communication file is not | 
accepting special interrupts when a slave end issues a READ, then 
that slave end will be trapped with a status of 7. 


The flag bits in X4 have the following meaning: 
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Bit Meaning 
0 If the source file is a master cammunication file, 


the corresponding slave end is trapped only if a 
nonzero status return occurs or if this bit is - 
zero. This bit must be zero if the source file is 
not a master cammunication file. 


1 If the source file is a slave communication or a . 
shared file, that file is reserved for the end 
issuing the READ command if this bit is one. Any 
prior reservation by this end is released if this 
bit is zero. This bit must be zero if the source 
file is not a slave communication file or a shared 
file. 


2-17 These bits are reserved for future use. They must 
be zero.. 


If a status return in status word 1 is not between 100 and 360 on 
completion of the READ, then status word 2 contains the 
difference between the number of words transferred and the number 
of words requested (i.e. it contains minus the number of words 
not transferred). If the status in word 1]. is between 100 and 
360, then status word 2 is zero. If the scurce file is a device 
file, then the lower half of status word 1 contains the status 
return from that device. 


The observant reader will note that the READ ccmmand is treated 
as a special case of the COPY command in which Xl and X2 are 
assumed to contain zeros. 


Status Returns 


0 Successful: all words were transferred. 


L Source file exhausted: more words were requested but 
could not be transferred. | 


2 Destination file exhausted: some words in the source 


file were not transferred since the end of the issuing 
job's storage was reached. 
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120 
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Command inappropriate: the READ was issued at the 
master end of a communication file without a corre- 
sponding WRITE operation outstanding at a slave end of 
that file. 


The source file pointer is out of bounds: either, 
(1) The pointer was initially out of bounds; 


(2) The other end of a communication file issued a 
MEMORY REQUEST which released job storage involved 
in the read; or 


(3) An attempt was made to read from the pure region 
of a job file which was swapped out of main 
memory. : 


The destination file pointer is out of bounds: either, 
(lL) The pointer was initially out of bounds; 


(2) A MEMORY REQUEST released job storage involved in 
the read; or 


(3) An attempt was made to read into the pure region 
of a job file which was swapoed out of main | 
memory. 


The communication file at whose slave end this command 
was issued is busy, either because another end has an 
operation outstanding, or because another end has 
reserved the ccmmunication file. 


The master end of the communication file at whose slave 
end this command was issued is not accepting special 
interrupts. 

Status was reset on the READ. 

Access error: the scurce file is not open with Read 
permission. Bits 0-8 of status word 1 contain the 
missing permission bit. 


Busy: another operation is outstanding on the source 
file. 
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200 
260 
300 


360 


400 
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X0 parameter error: X0 does not contain the file 
reference number of a file. 


X3 parameter error: X3 is zero or points to an 
out-of~bounds location. 


X4 parameter error: X4 contains extraneous or invalid 
flag bits. 


X7 parameter errors: X7 points out of bounds. 


Recoverable error: an error cccurred during trans- 
mission of data. The lower half of status word l 
contains the status from the device which generated the 
error. This return can cccur if a device file is being 
read via a ccmmunications file and the issuing jcb is 
Swapped out of main memory. 
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MME 500114: READ CATALOG 


XO File reference number of catalog 

XL Points to number Ml of first entry in the catalog to copy 
X3. Points to pointer to memory location M2 

X6 4 =Trap location 


x7 ~=—s Points to number of words N to copy 


N words of formatted catalog information, starting with the 
information for the first catalog entry whose number is greater 
than or equal to Ml, are written into the issuing job's storage 
starting at location M2. Read permission is required on the 
catalog. If the formatted catalog information is exhausted or if 
the end of the issuing joo's storage is reached, an end-of-file 
condition cccurs and data transmission stops. Upon completion of 
the copy, a trap cccurs to the location specified in X6. 


Tf XL is zero then the current value of the catalog's read/write 
pointer is used to specify an entry number. Upon completion of 
the copy, this pointer is updated to point to the entry past the 
last ce for which information was transferred. Note that since 
holes can occur in catalogs and since these holes have entry 
numbers, the value of the catalog's read/write pointer uron 
completion of a copy may not be equal to the number of entries 
for which information was transferred. X3 may not be Zero. 


Information for each entry in the catalog is formatted into an 
eight-word block. The block for entry number zero contains data 
pertaining to the catalog itself; blocks for other entry numbers 
contain information pertaining to file/catalogs cataloged in the 
catalog. 
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The format of the information for entry number zero which 
pertains to the catalog itself is as follows: 


Word | Function 

0 MAX 

1 ALOC (amount of storage used by entries) 

— Zero (unused) 

3 Zero (unused) 

4 Upper: access with which catalog is open 
Lower: preference and type of catalog 

Sy Upper:. zero (unused) 
Lower: number of entries, including holes, in 
catalog 

6 Zero (unused) 

7 Length of the catalog 


The format of the information pertaining to entries in the 
catalog is as follows: 


Word Function 
0-1 Name 
2-3 Password or name of trap program (zero if catalog 


is not open with Owner permission) 
4 Catalog access word 


5 Upper: days-used count 
Lower: preference and type of file/catalog 


6 Upper: coded date of last use 
Lower: coded date of last modification 


7 Length of file or MAX of catalog 
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See Chapter 9 for a more detailed explanation of these fields. 


If the status return in status word 1 is not between 100 and 360 
on completion of the copy, then status word 2 contains the 
difference between the number of words transferred and the number 
of words requested (i.e. it contains minus the number of words 
not transferred). I£ the status in word 1 is between 100 and 
360, then status word 2 is zero. 


Status Returns 


0 


20 
100 


120. 
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Successful: all words were transferred. 


Source file exhausted: more words were requested than > 
were contained in the formatted catalog information. 


Destination file exhausted: scme words of formatted 
catalog information were not transferred since the end 
of the issuing job’s storage was reached. 

Source file pointer out of bounds: there are no 
entries in the catalog with an entry number greater 
than or equal to Ml. . 

The destination file pointer is out of bounds: either, 
(1) The pointer was initially out of bounds; 


(2) A MEMORY REQUEST released job storage involved in 
the copy; or 


(3) An attempt was made to copy into the pure region 
of a job file which was swapped out of main 
memory . 

Status was reset. 

Access error: the catalog is not open with Read 

permission. Bits 0-8 of status word 1 contain the 

missing permission bit. 


Busy: another operation is outstanding on the catalog. 
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200 X00 parameter error: xX0 is zero or does not contain the 
file reference number of a catalog. 


220 Xl parameter error: Xl points to an out-of—bounds 
location. : 


260 X3 parameter error: X3 points to an out-of—bounds 
location or is zero. 


360 X7 parameter error: X7 points to an out-of-—bounds 
location or is zero. 


400 Recoverable error: an error occurred in reading the 
catalog. 


420 Unrecoverable error: information in the catalog has 
been destroyed. — 
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MME 500127: READ CATALOG AND OPEN FILES 


XO File reference number of catalog 

Xl Points to number Ml of first entry in the catalog to copy 
x2 Reserved for future use (must be zero) 

X3 Points to pointer to memory location M2 

x4 Access for OPEN (bits 0-8); Trap bit mask (bits 9-17) 

X5 Points to one word of coded dates (DLU/DLM) 

X6 Trap location 

x7 = Points to number of words N to copy 


AQ Slave trap identification words 


The READ CATALOG AND OPEN FILES command combines the functions of 
the READ CATALCG and the OPEN commands by simultaneously 
providing information about entries in a given catalog ard by 
opening those entries. It is intended primarily for use in 
privileged system modules and serves to minimize the number of 
disk accesses required for file system maintenance. 


When a READ CATALOG AND OPEN FILES command is issued, N words of 
formatted catalog information are written into the issuing job's - 
storage starting at location M2. This operation starts with the. 
information for the first entry in the catalog whose number is. 
greater than or equal to Ml. Formatted information is provided 
for all catalogs in the catalog being read. Information for 
migrated files is provided only if the date last used is greater 
than or equal to the coded DLM in the lower half of the word 
pointed to by X5. Information for other files is provided only 
if the file's date last used is less than or equal to the coded 
DLU in the upper half of the word pointed to by X5, or if the 
file's date last modified is greater than or equal to the coded 
DLM in the lower half of the word pointed to by X5. (Therefore, 
to get information on all files, the word should contain 0 in the 
lower half. To get information on files using only the DLU, the 
word should contain the desired DLU in the upper half and 777777 
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octal in the lower half. To get information on files using only 
the DIM, then the word should contain 0 in the upper half and the 
desired DLM in the lower half.) 


In addition, an attempt is made to open without a password each 
file/catalog for which information is transferred. If the 
information is exhausted or if the end of the issuing job's 
storage is reached, an end-of-file condition occurs and data 
transmission stops. Upon completion of the command, a trap 
eccurs to the location specified in X6. The date last used amd 
date last modified in the catalog entry for a file/catalog opened 
by the READ CATALCG AND OPEN FILES ccmmand will not be updated. 


Read permission is required on the catalog; search permission is 
also required if any file/catalogs are to be opened. Zero is an 
invalid parameter for x0 or X3. If Xl is zero, then the current 
value of the catalog's read/write pointer is used to specify an 
entry number. Upon completion of the command, this pointer is 
updated to coint to the entry past the last one for which 
information was transferred. Note that since holes can cccur in 
catalogs, and since these holes have entry numbers, the value of 
the catalog's read/write pointer upon campletion of the command 
may mot be equal to the number of entries for which information . 
was transferred. 


Information for each entry in the catalog other than entry zero 
is formatted into a ten-word block which contains information 
pertaining to that file/catalog. The information for entry zero 
pertains to the catalog itself and is formatted into a twenty- 
word block. 


-The format for entry zero (whose information pertains to the 
catalog itself) is as follows: 


word Function 

0 MAX 

1 ALOC (amount of storage used by entries) 
2 Upper: zero (unused) > | 
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Lower: number of fragments in which storage for 
catalog is allocated 


Zero (unused) 


Upper: access with which catalog is open 
Lower: preference amd type of catalog 


Upper: zero (unused) 

Lower: number of entries, including holes, in 
catalog a 

zero (unused) 

Length of catalog 

List of device addresses for catalog (zero if 


issuing job is not enabled with the Load-Dump 
permission) 


The format of the information pertaining to entries in the 
catalog is as follows: 


Word 


0-1 


Ov 
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Meanin 
Name 


Password or name of trap program (zero if catalog 
is not open with Owner permission) 


Catalog access word 


Upper: days-used count 


Lower: preference and type of file/catalog 


Upper: ceded date of last use 
Lower: ccded date of last modification 


Length of file or MAX of catalog 
Upper: status return from OPEN of file/catalog 


Lower: file reference number of file/catalog if 
opened 
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Number of fragments in which storage for 
file/catalog is allocated (zero if file/catalog 
not opened) 


The success of the open of each subfile/catalog is determined in 
the following manner: 


(1) 


(2) 


(3) 


(4) 


(5) 


(6) 


If the file/catalog is master or slave trapped, then 
the access bits are as allowed by the trapping program; 


If the catalog specified in X0 is open with Owner 
permission, then all access bits are allowed (unless 
the file/cataleg is trapped) ;. 


If the file/catalog is not trapped and the catalog 
being read is not open with Owner permission, then the > 
accesses allowed are those in bits 3-3 of the catalog 
access word; 


The allowed accesses are checked for usage conflicts 
and masked off if any conflicts cccur; 


Unless the job issuing the command is Load-Dump 
enabled, : 


(a) Append permission is masked off if the catalog's 
MAX has been exceeded, 


(b) All access bits are masked. off if the allocated. 
storage for the catalog exceeds twice its. 
permissible MAX; 


Any remaining bits are ANDed with the requested 
accesses, and bit 0 is set to 1 if the file/catalog 
being opened is a catalog. 


If any accesses remain in bits 5-8, then those accesseses are 
returned in bits 0-8 of word 8 of the entry information block. 
In additicn, the nine user access bits from 9-17 of the catalog 
access word are ORed into bits 9-17 of the access word in the 
file/catalog's file control bleck. The status return from the 
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open which occurs in word 8 of the entry information block is one 
of the following: 


Status Returns 


Q Successful: the accesses in bits 0-8 were obtained. 


1 Partial success: the accesses in bits 0-8 were 
obtained but differ from those requested. 


2 Lockout: all allowable accesses are currently busy. 


5 Unsuccessful: no accesses were allowed. Bit 0 will be 
1 if the file/catalog is a catalog. 


10 File off line: the upper half of status word 2 
contains the purged date, and the lower hnalf-word 
contains the reel number, oreference, and TYPE. 


40 Quotas exceeded: either 


(1) The job has exceeded its allotted state vector 
length, or 


(2) The job is not enabled for Load-Dump permission 
and the allccated storage for the catalog is over 
twice the permissible MAX. 


60 Out of storage: the Executive's table of opened files 
Ls: full. 


100 Access error: the catalog is not open with Search 
permission; bits 0-8 contain the missing permission 
bit. 


On completion of the command, if the status return in status word 
1 is mot between 100 and 360, then status word 2 contains the 
difference between the number of words transferred and the number 
of words requested (i.e. it contains minus the number of words 
not transferred). If the status in word 1 is between 100 and 
360, then status word 2 is zero. 
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Status Returns 


14 


20 


100 


120 


~ 200 


220 
240 
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Successful: all words were transferred ard all 
available file/catalogs were opened. 


Source file exhausted: more words were requested than 
were contained in the formatted catalog information. 


Destination file exhausted: same words of formatted 
catalog information were not transferred since the end 
of the issuing job's storage was reached. 

Source file pointer out of bounds: there are no 
entries in the catalog with an entry number greater 
than or equal to ML. 

The destination file pointer is out of bounds: either, 
(1) The pointer was initially cut of bounds; 


(2) A MEMORY REQUEST released job storage involved in 
the copy; or 


(3) An attempt was made to copy into the pure region 
of a job file which was swapped out of main 
memory. 


The current’ length of the issuing job's state vector 
Will not accemmodate another file control block. 


Status was reset. 

Access error: the catalog is not open with Read 
permission; bits 0-8 of status word 1 contain the 
missing permission bit. 


Busy: another operation is outstanding on the catalog. 


XO parameter error: XO is zero or does not contain the 
file reference number of a catalog. 


Xl parameter error: Xl points out of bounds. 


X2 parameter error: X2 was not zero. 
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260 X3 parameter error: X3 points out of bounds or is 
zero. 


320 X5 parameter error: X5 points out of bounds. 
360 X7 parameter error: X7 points out of bounds. 


400 Recoverable error: an error occurred in reading the 
catalog. 


‘420 Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500116: REPLACE 


XO File reference number of initial catalog to search 

Xl Points to name of file/catalog to replace 

x2 ~=File reference number of scratch file/catalog 

X3 Points to password (or is zero) 

X4 (bits 0-8) must be zero; (bits 9-17) trap bit mask 

X5 Reserved for future use (must be zero) 

X6 Trap location 

X7 = =©Number of entries in treename (if zero, then 1 is assumed) 


AQ Slave trap identification words 


The REPLACE command attempts to open the named file/catalog with 
all permissions and to replace it with the specified scratch 
file/catalog. 


In this respect it is roughly equivalent to the sequence of 
commands ERASE, CATALOG; however, the REPLACE command has a 
number of advantages over this combination of commands. It 
Minimizes the number of catalog accesses required to cerform the 
combined function, and it permits the replacement of a file/ 
catalog with a shorter version in a catalog whose MAX has been 
exceeded even though the MAX may still be exceeded after the 
replacement. 


The replacement will not be allowed if another job has the 
file/catalog ccen with Write permission; however Append 
permission may be locked out at the time of the REPLACE. 


The replacement will be made if Read, Write, and Append 
permissions are present in the available accesses, unless the 
allocated storage for the catalog exceeds its permissible MAX. 
In this latter case the replacement will be made only if the 
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length of the scratch file or MAX of the scratch catalceg is less 
than or equal to the length or MAX of the file/catalog which it 
replaces. If after performing such a replacement, the catalog's 
MAX is still exceeded, then Append permission will be removed 
from the accesses available. 


If the replacement is successful, then the file/catalog specified 
in X2 becomes a cataloged file/catalog open with the accesses 
which were determined to be available, and the catalog entry is 
updated correspondingly. In addition to the available accesses 
which are returned in status word 1 of the trap, nine user access 
bits can be obtained by issuing a REQUEST STATUS. These user 
access bits are obtained from bits 27-35 of the searched 
catalog's access word if the file/catalog was opened with a 
password, and from bits 9-17 of this access word if the 
file/catalog was opened without a password or if it was protected 
- by a trap program. If the replacement was unsuccessful, then the 
file/catalog remains a scratch file/catalog ard the catalog entry 
remains unchanged. 


A job which attempts to replace a file/catalog first has its 
catalog word allotment decremented by the length of the scratch’ 
file or of the scratch catalog header. If the replacement 
succeeds then his scratch quotas are incremented by the same 
amount. If the replacement does not succeed, then this allotment 
is incremented by the amount of the original debit. 


A file may not be replaced by a catalog, nor may a catalog be 
replaced by a file. Replacement of a cataloged file/catalog dces 
not affect the name, password, or access word in the catalog 
entry. The replacement scratch file/catalog must not have been 
passed to the issuing jod with the return bit set. 


Upon completion of the command, a trap occurs to the lecation 
specified in x6. If the replacement was successful, bits 0-8 of 
status word 1 contain the accesses with which the file/catalog is 
now cpen. Status word 2 contains the length of the file or MAX 
of the catalog. 
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Status Returns 


alal 
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Successful: the file/catalog was replaced and is now 
open with the accesses in bits 0-8. 


Partial success: the file/catalog was replaced and is 
now open with the accesses in bits 0-8. Append 
permission has been masked off since the searched 
catalog's MAX is exceeded. 


Lockout: the cataloged file/catalog is currently in 
use with Write permission. 


Not found: the desired file/catalog was not fcund in 
the. searched catalog. 


Protection violation: the specified password was 
wrong es 


Unsuccessful: one of the Read, Write, or Append 
permisSions was not allowed. 


Bad treename: Search permission was available on same 
intermediate catalog and the next entry in the treename 
was not the last entry, but was the name of a file 
rather than a catalog. 


Fetch error: either 

(1) An error of type 3, 4, 5, or 6 cccurred and Searcn 
permission was not available on the catalog in 
which the search was being performed; or 

(2) Search permission was not available on the (N-1)st 


catalog and fetch permission was not available on 
the a aaa 


REPLACE disuiigted: the named file/catalog is a device 
file. 
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40 Quotas exceeded: either 


(1) The length of the scratch file or catalog header 
exceeds the job's remaining catalog word 
allotment, or 


(2) The specified catalog's MAX is exceeded, and the 
length of the scratch file or MAX of the scratch 
catalog is greater than the length or MAX of the 
file/catalog to be replaced. 

60 Out of storage: either 
(1) The Executive's table of opened files is full, or 


(2) A new entry had to be made in the cataleg for the 
replacement and either 


(a) The catalog already had 4095 entries, 

(b) The Executive could not allocate sufficient 
storage for a required extension of the 
catalog, or 

(c). It is not possible to append to the catalog 
Since it either is a main-memory catalog or 
is already allocated in twelve fragments. 


120 Busy: another operation is outstanding on either the 
catalog or the scratch file/catalog. 


200 X0 parameter error: X0 does not contain the file 
reference number of a catalcg. 


220 Xl parameter error: Xl points out of bounds. 
240 X2 parameter error: either 


(1) X2 does not contain the file reference number of a 
scratch file/catalcog, 


(2) The scratch file/catalog was passed to the issuing 
job with the return bit set, 
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(3) The type of the scratch file/catalog dees not 
match the type of the file/catalog it is to 
replace, or 

(4) The scratch file/catalog has a preference of 0, l, 

- 2, or 4 and may only replace a file in a core 
catalog. 


260 X3 parameter error: the pointer to the password is out 
of bourds. . 


300 X4 parameter error: bits 0-8 of x4 were not zero. 
320 X5 parameter error: X5 was not Zero. 


360 X7 parameter error: X7 was greater than 10 (maximum of 
10 names in the list of entries pointed to by X1).. 


400 Recoverable error: an error cccurred in reading the 
catalog. 


420 Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500115: REQUEST STATUS 


xO File reference number of file/catalog or zero 
X3 Points to pointer to memory location M2 
a X6 Trap location 
X7 Points to number of words N to read 
N words of status information for the file/catalog are read into 
the issuing job's memory starting at location M2. Upon 


completion of the command, a trap occurs to the location 
specified in X6. 


If XO is zero, then.the status information pertains to the Job 
issuing the command and has the following format: 


word Meaning - 


0 Job's remaining catalog word allotment 

1 Job's remaining scratch word allotment 

2 CRU limit for job (in 1/64 millicRU) — not CRUs 
remaining 

3 Number of I/O units used 

4—5 Identifying words from run list of the RUN command 


which spawned this job 


6-7 Identifying words from run list of the RUN command © 
which spawned the job which spawned this one | 


bears Ete., for each job above this one in the job tree © 


If XO contains the file reference number of a suspended or 
terminated job file, then the status information for the job fil 
specified has the following format: 
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Word Meanin 

0 Accesses/Type (see below) 

1 Job length (core size) [will be zero for a 
terminated job file] 

2 Computer resource units (CRUs) consumed 

3. T/O units consumed 

4 Central processor units consumed 

5 Core units consumed 


Note: The quantities in words 2 through 5 include resources 
consumed by all terminated infra jobs. 


If X0 is nonzero ard is not the file reference number of a job 
file or the slave end of a communication file, then the status 
information for the file/catalog specified has the following 
format: 


Word Meaning 


0 . bits 0-17 (upper): accesses with which the 
file/cataleg is open 
bits 18-26: zero 
bits 27-28: preference adjustment 
bits 29-31: preference (see Chapter 9 for 
preferences) 
bits 32-35: type (see Chapter 9 for types) 


i | Length of file or MAX of catalog 
2 Read/write pointer 
3 Upper: Maximum accesses available on the file 


through an ALTER ACCESSES ccmmand (qd.v.). 

Lower: Unique Identifier. This field can be used 
by a job to determine whether two FRNs actually 
access the same file. The identifier will be the 
same for the two FRNs if and only if they access 
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the same file. The value of this field is 
undefined for other than cataloged files. 


4—-N Message specified by PASS command 


The message starting in word 4 is available only if the 
file/catalog was passed to the issuing job by a PASS command and 
if the REQUEST STATUS is the first file operation issued on the 
file/catalog. (See PASS. ) 


If XO contains the file reference number of the slave end of a 
communication file, then a special interrupt number 13 (slave erd 
issued REQUEST STATUS) is generated at the master end. The © 
second interrupt word contains the number of words requested. No 
status information for the file is supplied by the Executive. 
Instead, it is the duty of the master end of the communication 
file to write status information to the slave end via a WRITE or 
COPY command. In other words, a REQUEST STATUS issued at the 
Slave end of a communication file cehaves in the same manner as a 
READ command, except that the communication file can never be 
reserved by a REQUEST STATUS command. If the communication file 
is busy, either because another end has an operation outstanding 
on it, or because another erd has reserved ic, the slave end 
issuing the REQUEST STATUS ccmmand will be trapped with a status 
of 6. If the job at the master end of a communication file is 
not accepting special interrupts when a slave end issues a 
REQUEST STATUS, then that slave end will be trapped with a status 
of 7. Jf the communication file is reserved for this end, it 
will be released. 


If the status return in status word 1 is not between 100 and 360 
on completion of the command, then status word 2 contains the 
difference between the number of words transferred and the number 
of words requested (i.e. it contains minus the number. of words 
not transferred). I£ the status. in word 1 is between 100 and 
360, then status word 2 is zero. 
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Status Returns 


20 
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Successful: all words of status information were 
transferred. 


Source file exhausted: more words of status informa- 


tion were requested than existed. 


Destination file exhausted: scme words of status 
information were not transferred since the end of the 
issuing job's storage was reached. 


Source file pointer out of bounds: either, 


(1) This file/catalog has been passed with a message 
and the supra jcb has released the job storage 
containing the message; or 


(2) This is the slave end of a communication file and 
the master end is attempting to supply status 
information from a scurce file wnose pointer is 
out of bounds. 


The destination file pointer is out of bounds: either, 
(1) The pointer was initially out of bounds; 


(2) A MEMORY REQUEST released jcb storage involved in 
the request; or 


(3) The issuing job was swapped out of main memory © 
while the master end of a communication file was 
writing into the job's pure region. 


- Communication file busy: the communication file at 


whose slave end this command was issued is busy because 
another end has an operation outstanding on it, or has. 
reserved it. 


The master end of the communication file at whose slave 
end this command was issued is not accepting special 
interrupts. . 


Status was reset. 
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120 


200 


260 


360 
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Busy: another operation is outstamding on the 
File/catalog. 


XO parameter error: X0 does not contain a valid file 
reference number or contains the file reference number 
of a former cammunication file whose other end has been 
closed. 


X3 parameter error: X3 is zero or points out of 
bounds. 


X7 parameter error: X7 points out of bounds or points 
to a length greater than 2718. 


Recoverable error: an error occurred during the 
transmission of the message on a passed file/catalog or 
of the status information on the slave end of a 
communication file. The lower half of status word 1 
contains the status from the device which generated the 
error. 
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MME 500135: RESET STATUS 


XO File reference number of file/catalog 
x4 Flag bits 


X6 Trap location 


The file/catalog is forced into an idle state. Any file 
operation outstanding on the file/catalog is halted. The commard 
which initiated the operation is trapped, generally with a status 
return of 20 (status was reset). Status cannot be reset on a 
file/cataleg which has been passed to an infra job and which has 
not yet been returned. A file reference number of zero is 
invalid. Upon completion of the command, a trap occurs to the 
location specified in x6. | 


A RESET STATUS issued on a running job will suspend execution of 
that job and all jobs running below it until a CCNTINUE ccammand 
is issued. 


A RESET STATUS issued on a communication file for wnich an 
operation is outstanding at both the master ard a slave end will 
cause status to be reset at both ends. A RESET STATUS issued on 
the slave end of a ccmmunication file when no operation is 
outstanding at the master end of that file will generate a 
special interrupt number two (slave end issued RESET STATUS) at 
the master end and will cause the master end to be busy until a 
RESET STATUS is issued on it. A RESET STATUS issued at the slave 
end of a communication file will cause the file to be released 
(if it was reserved for that end). 


The flag bits in X4 have the following meanings: 


Bit Function 


0 Unassigned, must be zero. 
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1 Must be zero unless X0 contains the file reference 
number of the master end of a communication file. 
In that case, the file will be reserved for the 
master end if this bit is one (see Section 5.4). 
If this bit is zero, any prior reservation by the | 
master end will be released. 


2-17 Unassigned, must be zero. 
A RESET STATUS issued on the source file for pure procedure will 


unbusy that file and declare the job to be impure; i.e. it has 
the same effect as a PURE command in which X7 is zero. 


A RESET STATUS on a file opened in shared mode will cause the 


file to revert to an idle, unreserved (unlocked) state at the 
issuing end. | 


Status Returns 


0 Successful: status was reset. 


1 A RESET STATUS is already in progress on this file/ 
catalog. 


120 Busy: the file/catalog has been passed to an infra 
job. 


200 XO parameter error: 0 does not contain a valid file 
reference number. : 


300 X4 parameter error: X4 contains invalid flag bits. 
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MME 500120: RUN 


The RUN MME is very similar to the EXECUTE MME (500117) and 
differs only in the following: 


(1) Upon initiation of the job, the source file is closed 
and its file reference number is assigned to the newly 
created job file. This remains open with all accesses 
possessed by the source file except Append permission 
until the job file is closed. 


(2) The file reference number of the job file will not be 


placed in the lower half of status word 1 of the trap 
block specified by X6. 
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MME 500110: SCRATCH 


XO File reference number of file 


X6 Trap location 


The specified file, which must be open with Write and Append 
permissions, is erased and both its length and its read/write 
pointer are set to zero. Upon completion of the command, a trap 
occurs to the location specified in X6. 


A SCRATCH command issued at the slave end of a communication file 
will generate a special interrupt number 14 (slave end issued 
TRUNCATE) at the master end. The second word of the special 
interrupt will be zero (see TRUNCATE). If the communication file 
is busy, either because another end has an operation outstanding 
on it, or because another end has reserved it, the slave end 
issuing the SCRATCH command will be trapped with a status of 6. 
If the job at the master end of a communication file is not 
accepting special interrupts when a slave end issues a SCRATCH, 
then that slave end will be trapped with a status of 7. A 
SCRATCH cammand cannot be issued on the master end of a communi- 
cation file. 


A job which scratches a scratch (cataloged) file will have its 
scratch (catalog) word allotment incremented by the length of the 
file. 


The cbservant reader will notice that the SCRATCH command is 
treated as a special case of the TRUNCATE command in which the 
A-register is assumed to contain a zero. 


Status Returns 
0 Successful: the file was scratched. 


6 Communication file busy: the communication file at 
wnose slave end this command was issued is busy because 
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another end has an operation outstanding on it or has. 
reserved it. 


The master end of the communication file at wnose slave 
end this command was issued is not accepting special 
interrupts. 


Status was reset on the TRUNCATE. 


Access error: the file is not open with Append and 
Write permissions; bits 0-8°of status word 1 contain 
the missing access bits. 


Busy: another command is outstanding on the file to be 
scratched. 


XO parameter error: X0 is zero and does not contain a 
valid file reference number, or contains the file 
reference number of a device, job, or master cammunica- 
tion file. | 
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MME 500113: SET POINTER 


XO File reference number of file/catalog 


X6 Trap location 


A Setting for read/write pointer 


The read/write pointer of the file/catalog is set to the 
specified value, and a trap occurs to the location specified in 
X6. Zero is an invalid file reference number. 


A SET POINTER command issued at the slave end of a communication 
file will generate a special interrupt number 15 (slave end 
issued SET POINTER) at the master end of the file. The second 
interrupt word will contain the specified setting for the 
read/write pointer. If the communication file is busy, either 
because another end has an operation outstanding on it, or 
because another end has reserved it, the slave end issuing the 
SET POINTER ccommand will be trapped with a status of 6. If the 
job at the master end of a communication file is not accepting 
special interrupts when a slave end issues a SET POINTER, then 
that slave end will be trapped with a status of 7. A SET POINTER 
command may not be issued on the master end of a communication 
file. 


Status Returns 


0 Successtul. 


L Pointer out of bounds. Register A specifies a pointer 
greater than the length of the file, or the file is a 
catalog or device file and register A is not less than 
2°18. 


6 Communication file busy: the communication file at 
whose Slave end this cammand was issued is busy because 
another end has an operation outstanding on it or has 
reserved it. 
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a The master end of the communication file at whose slave 
end this command was issued is not accepting special 
interrupts. 


20 Status was reset on the SET POINTER. 


120 Busy: another operation is outstanding on the file/ 
catalog. 


- 200 XO parameter error: X0 is zero or does not contain the 
file reference number of a file/catalog. 
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MME 500141: TALLY CATALOG 


XO File reference number of initial catalog to search 

XL Pointer to a tally word 

| 2. File reference number of file to be cataloged 

X3. File reference number of alternate initial catalog. . 

X4 Pointer to 2 words of permission and access information 


X5 Pointer to two words for name of file/catalog cataloged by 
the Executive | 


X6 Pointer to trap block 


X7 Pointer to usage and dates (Load-Dump enabled jobs only) or 
zero | | 


The specified scratch file/catalog is cataloged in the file 
system in a catalog denoted by a standard treename. 


First an attempt to open the specified file is made using TALLY 
OPEN (MME 500136). The trap bit mask for the search is in bits 
9~17 of the first word pointed to by X4. If bit 4 (020000 
{[octal], the escape convention bit) is set in the upper half of 
this first word, then all special scanning conventions are 
disallowed, and the catalog will be trapped with a format error 
if the treename contains a special first name. The name and 
password of the file/catalog to be cataloged cannot be specified 
with the "/" ccnvention, and the catalog will be trapped with a 
format error if that is attempted. For more information on tally 
operations, see Chapter 8. 


If the Executive receives a file-not-found status for the last 
file/catalog then that file/catalog is cataloged if Append 
permission is available on the destination catalog. For example, 
if the treename is A:B:C, then C is cataloged in A:B if and only 
if A:B exists, Append permission is available on B, and A:B:C 

_ dees not already exist. The secord word pointed to by X4 is the 
access word with which the file will be saved. If the treename 
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includes a password for the last file/catalog, then this password 
will be put on the cataloged file/catalog. 


If the job is enabled with Load-Dump permission and X7 is 
non-zero, then it must point to two words of usage and dates 
information. The upper half of the first word contains an 
integer used to set the file's days-used count; the lower half 
contains type information or is zero. The second word contains a 
coded Date Last Used in the upper half and coded Date Last 
Modified in the lower half. See MME CATALCG or Chapter 9 for 
more details on usage and dates information. 


Upon completion of the cperation, the job’s scratch word 
allotment is incremented by the length of the file or of the 
catalog header, and its catalog word allotment is decremented by 
this quantity plus the length of the entry created in the 
catalog. Finally a trap cccurs to the location specified by x6. 


Tf the command was unsuccessful, then status word 1 contains the 
reason for the failure. If the status is 12 or 40 or greater, 
the. two words pointed to by XS are undefined. If the status was 
7 (fetch error) then the two words are cleared. Otherwise, the 
last file name scanned is placed in the two words. (These words 
need mot be aligned on a even-word boundary.) If the status 
returned from the catalog is 12 (format error), then status word 
2 will cmtain a. substatus, and a tally count and character 
position pointing to the character where the format error was 
detected. See Chapter 8 for more information on format errors. 


Status Returns 


0 Successful: the file/catalog was cataloged. 

1 Illegal trap protection request: a master trap 
protection bit which is not allowed to the issuing job 
has been specified. : 


2 Duplicate name: an entry with the given name is 
already in the catalog. 
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Not found: Search permission was available on same 
intermediate catalog and the next file/catalog was not 
found in it. 


Protection violation: Search permission was available 
on some catalog, and the password specified for the 
next file/catalog was wrong. 


Bad treename: Search permission was available on some 
intermediate catalog, and the next entry in the 
treename was not the last entry, but was the name of a 
file rather than a catalog. 


Fetch error: an error of type 2, 3, 4, or 6 occurred 
and Search permission was not available on the oe 
in which the search was being performed. 


Format error: see Chapter 8 for possible types of 
errors. . 


Illegal usage and dates: the usage information pointed 
to by X7 was illegal; either the date last used was 
zero, Or the preference or type information was wrong. 


Preference too low: the specified file has a 
preference of 0, 1, 2, or 4 and may be cataloged only 
in a core catalog. 


Quotas exceeded: either 


(1) The job has exceeded its allotted state vector 
length; or 


(2) Allocated storage for the next to last catalog is 
over twice the permissible MAX, and files must be 
erased from this catalog before any can be opened. 


Out of storage: the Executive's table of opened files | 
is full. 


Access error: The initial catalog to search is not | 
open with Search permission; or the last catalog before 
the file/catalog to be cataloged lacks Append 
permission. Bits 0-8 of status word 1 contain the 
missing permissions. 
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Busy: another cammand is outstanding on the catalog 
specified in XO or X3. 


XO parameter error: X0 does not contain the file 
reference number of a catalog. 


X1 parameter error: the pointer to the tally word is 
out of bounds. 


X2 parameter error: X2 does not contain the file 
reference number of a scratch file/catalog. 


X3 parameter error: X3 dees not contain the file 
reference number of a catalog. 


X4 parameter error: the two-word pair pointed to by x4 
was cut of bounds or an illegal bit was set. 


X¥5 parameter error: X5 pointed to a two-word pair 
which was out of bounds. 


X7 parameter error: the two-word pair pointed to by X7 
was out of bounds, or the job was not Load-Dump enabled 
and X7 was nonzero. 


Recoverable error: an error cccurred in reading an 
intermediate catalog. 


Unrecoverable error: information in an intermediate 
catalog has been destroyed. 
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MME 500137: TALLY ERASE 


XO File reference number of initial catalog to search 


Xl Pointer to a tally word 


BS 


Reserved for future use (must be zero) 
X3. File reference number of alternate initial catalog 


x4 (bits 0-3,5-8) must be zero, (bit 4) escape special 
convention, (bits 9-17) trap bit mask 


X5 Pointer to two words for name of file/catalog erased by the 
Executive 


X6 Pointer to trap block 
X7 =©Reserved for future use (must be zero) 


AQ Passed to slave trap program if file is slave trapped 


The TALLY ERASE command attempts to open the specified file/ 
catalog with Read, Write, and Append permissions using TALLY OPEN 
(MME 500136). If the open is successful then the Executive 
destroys the file/catalog together with its catalog entry. 


If bit 4 (020000 cctal, the escape convention bit) is set in x4, 
then all special scanning conventions are disallowed, and the 
erase will be trapped with a format error if the treename 
contains a special first name. 


For more information on tally operations, see Chapter 8. 


Catalog quota checks are suspended for the TALLY ERASE command; 
hence, it can be used to destroy files in catalogs whose quotas 
have been exceeded. Conflict checks with accesses currently held 
by other jobs having the given file/catalog open are suspended 
for all accesses except Write. A TALLY ERASE command may 
therefore be used to destroy a file/satalog which is cpen, 
provided that it is not open with Write permission. With the 
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provided that it is not open with Write permission. With the 
exception of this and the catalog quota check, a TALLY ERASE 
command is identical in effect to the sequence of cammands TALLY 
OPEN, UNCATALOG, and CLOSE. 


A job which issues a successful TALLY ERASE command will have its 
catalog word allotment incremented by the length of the file or 
of the neader of the catalog which was erased and also by the 
length of the catalog entry. 


On completion of the command, a trap occurs to the location 
specified in X6. 


If the command was unsuccessful, then status word 1 contains the 
reason for the failure. If the status is 12 or 40 or greater, 
the two words pointed to by X5 are undefined. If the status was 
7 (fetch error) then the two words are cleared. Otherwise, the 
last file name scanned is placed in the two words. (These words 
need not be aligned on a even-word boundary.) If the status 
returned from the open is 12 (format error), then status word 2 
will ccntain a substatus, and a tally count and character 
positicn pointing to the character where the format error was 
detected. See Chapter 8 for more information on format errors. 


Status Returns 


0 Successful: the file/cataleg was erased. 


2 Lockout: the file/catalog is currently in use with 
Write permission. 


3 Not found: Search permission was available on some 
intermediate catalog and the next file/catalog was not 
found in it. _ : 


4 Protection violation: Search permission was available 


on same intermediate catalog and the password specified 
for the next file/catalog was wrong. 
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Fail: Search permission was available on the next to 
last catalog and none of the requested accesses were 
available on the file/catalog. 


Bad treename: Search permission was available on some 
intermediate catalog and the next entry in the treename 
was not the last entry, but was the name of a file 
rather than a catalog. 


Fetch error: either 

(1) An error of type 3, 4, 5, or 6 cccurred and Search 
permission was not available on the catalog in 
which the search was being performed; or 

(2) Search permission was not available on the next to 
last catalog and Fetcn permission was not 
available on the file/catalog. 


TALLY ERASE disallowed: the named file/catalog is a 
device file. 


Format error: see Chapter 8 for possible types of » 
errors. 


Access error: the initial catalcg to search is not 
open with Search permission; bits 0-8 of status word 1 
contain the missing permission bit. 


Busy: another cammand is outstanding ¢ on the catalog 
specified in X0 or X3. 


XO parameter error: X00 does not contain the file 
reference number of a catalog. 


Xl parameter error: the pointer to the tally word is 
out of bounds. 


X2 parameter error: X2 was nonzero. 


X3 parameter error: X3 dees not contain the file 
reference number of a catalog. 


X4 parameter error: bits 0-3 or 5-8 were nonzero. 
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320 X5 parameter error: X5 pointed to a two-word pair 
which is out of bourds. 


360 X7 parameter error: X7 was nonzero. 


400 Recoverable error: an error cccurred in reading an 
intermediate catalog. 


420 Unrecoverable error: information in an intermediate 
catalog has been destroyed. 
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MME 500136: TALLY OPEN 


File reference number of initial catalog to search 


XO 

Xl. Pointer to a tally word 

X2 Reserved for future use (must be zero) 
X3 


File reference number of alternate initial catalog 


X4 Desired accesses on the file, trap bit mask and escape 
special convention bit 


X5 Pointer to two words for name of last file/catalog accessed 
by the Executive 


X6 Pointer to trap block 
X7 Reserved for future use (must be zero) 


AQ Passed to slave trap program if file is slave trapped 


The specified file (denoted by a string of ASCII characters) is 
located in the file system and opened. A file reference number 
is returned, which is used on all subsequent operations on the 
file. 


The tally word pointed to by Xl is a tally word for the treename 
of the file to be opened. A treename is defined to be a list of. 
zero Or more catalegs separated by colons (:), with a file name 
or catalog name at the end. Any catalog/file in the treename may 
have a password; the password immediately follows the catalodg/ 
file name and is set off from it by a ccmma (,). 


If bit 4 (020000 octal, the escape convention bit) is set in x4, 
then all special scanning conventions are disallowed, and the 
open will be trapped with a format error if the treename contains 
a special first name. For more information on tally cperations, 
see Chapter 8. 
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The procedure for opening the file/catalog specified by the 
treename is as follows. If a special first-name convention is 
not used, then the initial catalog specified by x0 is searched 
for the catalog specified by the first entry of the treename; if 
XO is zero, then the Master File Directory (MFD) is searched. If 
one of the special first-name conventions is used, then the | 
initial catalog specified by X3 is searched regardless of what is 
in X0. As each succeeding catalog in the treename is found, it 
is searched for the catalog specified by the next entry of the 
treename. Finally the next to last name in the treename is 
searched for the file/catalog specified by the last name. 


For. every file/catalog in the treename, the accesses available 
are determined in one.of two manners: 


(1) If Search permission was available on the previous catalog, 
then the accesses available on the current file/catalog are 
those allowed without a password (bits 3-8 of the current 
file/catalog's access word), or those allowed with a 
password if one is given (bits 21-26 of the current file/ 
catalog's access word), or these returned by the master trap 
program if the catalog is so protected. 


Tf Cwner permission was available on the previous catalog 
and the current file/catalog is not protected by the master 
trap program, then all accesses are allowed on the current 
fFile/catalog. 


Slave trapping programs are run only on the last file/ 
catalog in the treename. If a supra catalog is slave 
trapped, the untrapred accesses are used. 


(2) If Search permission was not available on the previous 
‘catalog, then the accesses as given above are examined for 
the presence of the fetch bit (bit 4). If the fetch bit is 
on, then accesses are granted on the current file/catalog 
just as if Search permission had been available on the 
previous catalog. If the fetch bit is not on, then no > 
accesses are granted on the current file/catalog. 


Next the access bits allowed on the last file/catalog are checked 
for use conflicts with accesses currently held by other jobs with 
the same file/cataleg open. Access bits that are in conflict are 
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masked off. In addition, Append permission is masked off if the 
catalog MAX of the next-to-last entry has been exceeded. All 
access bits are masked off if the allocated storage for any entry 
exceeds twice its permissible MAX. Accesses are ANDed with those 
requested, and, finally, bit 0 of the access is set to 1 if the 
file/catalog is a catalog. The file/catalog is opened if any 
accesses remain in bits 5-8. 


If bit 1 of x4 (200000 octal) is set, then the Executive will — 
open the file in shared mode. If the file is not already open in 
unshared mode and bit 3 (040000 octal) is set in its access word, 
then the available accesses will be reduced to a maximm of Read 
and Write, and those accesses, if any, will be returned. 


On completion of the command, a trap occurs to the location » 
specified in X6. If the file/catalog was opened successfully, 
then the access bits obtained are returned in bits 0-8 of status 
word 1, the new file reference number of the opened file/catalcg. 
in bits 18-35 of status word 1, and the length of the opened file 
or the MAX of the opened catalog in status word 2. 


In addition to the access bits returned in status. word 1 of the 
trap, nine user access bits can be obtained by issuing a REQUEST 
STATUS. These user access bits are obtained fram bits 27-35 of 
the cpened file/catalog's access word if the file/catalog was 
opened with a password. If the file/catalog was opened without a 
password or if it was protected by a trap program, the user 
access bits are obtained frem bits 9-17 of the access word. 


If the command was unsuccessful, then status word 1 contains the 
reason for the failure. If the status is 12 or 40 or greater, 
.the two words pointed to by X5 are undefined. If the status was 
7 (fetch error) then the two words are cleared. Otherwise, the 
last file name scanned is placed in the two words. (These words 
need not be aligned on a even-word boundary.) If the status 
returned from the open is 12 (format error), then status word 2 
will contain a substatus, and a tally count and character 
position pointing to the character where the format error was 
detected. See Chapter 8 for more information on format errors. 
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The read/write pointer of the opened file/catalog is initialized 


to zero. 


Status Returns 
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Successful: the accesses in bits 0-8 were obtained and 
are the same as those requested. 


Partial success: the accesses in bits 0-8 were 
obtained but differ from those requested. This status 
return can cccur if bit 0 of the requested access is 0 
(is 1) and the opened file/catalog is a catalog (is a 
file). 


Lockout: due to usage conflicts, none of the requested 
accesses was available on the file/catalog. 


Not found: Search permission was available on scme 
intermediate catalog and the next file/catalog was not 
found in it. 


Protection violation: Search permission was available 
on sane intermediate catalog and the password specified 
for the next file/catalog was wrong. 


Fail: Search permission was available on the next to 
last catalog and none of the requested accesses was 
available on the file/catalog. 


Bad treename: Search permission was available on same 
intermediate catalog and the next entry in the treename 
was not the last entry, but was the name of a file 
rather than a catalog. 


Fetch error: either 


(1) An error of tyre 3, 4, 5, or 6 cccurred and Search 
permission was not available on the catalcg in 
which the search was being performed, or 


(2) Search permission was not available on the next to 


last catalog and Fetch permission was not 
available on the file/catalog. 
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Off-line file: the file to be opened was an off-line 
file. Bits 0-8 of status word 1 contain the accesses 
that would have been available were the file cataloged. 
Status word 2 contains the DLU in the upper half, the 
reel number in bits 21-26, and the preference and type 
in bits 29-35. 


Format error: see Chapter 8 for possible types of 
errors. 


Quotas exceeded: either 


(1) The job has exceeded its alloted state vector 
length; or 


(2) Allocated storage for the next to last catalog is 
over twice the permissidle MAX, and files must be 
- erased from this catalog before any can be opened. 


Out of storage: the Executive's table of opened files 
is full. 


Access error: the initial catalog to search is not 
open with Search permission; bits 0-8 of status word 1 
contain the missing permission bit. 


Busy: another command is outstanding on the catalog 
specified in x0. 


XO parameter error: xX0 dces not contain the file 


reference number of a catalcg. 


Xl parameter error: the pointer to the tally word is 
out of bounds. 


X2 parameter error: X2 was nonzero.: 


X3 parameter errer: X3 does not contain the file 
reference number of a catalog. 


X5 parameter error: X5 pointed to a two-word pair 
which was out of bounds. 


X7 parameter error: X7 waS nonzero. 
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400 Recoverable error: an error occurred in reading an 
intermediate catalog. 


420 Unrecoverable error: information in an intermediate 
catalog has been destroyed. 
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MME 500140: TALLY REPLACE 


XO File reference number of initial catalog to search 
Xl Pointer to a tally word 

X2. File reference number of scratch file/catalog 

X3 ©=File reference number of alternate initial catalog 


x4 (bits 0-3,5-8) must be zero, (bit 4) escape special 
convention, (bits 9-17) trap bit mask 


X5 Pointer to two words for name of file/catalog replaced by 
Executive 


X6 Pointer to trap block 
X7 ~~ ~=Reserved for future use (must be zero) 


AQ Passed to slave trap program if file is slave trapped 


The specified scratch file/catalog replaces a file/catalog in the 
file system (denoted by a standard treename). © 


The TALLY REPLACE command attempts to open the file/cataleg using 
TALLY OPEN. If Read, Write, and Append permissions are available 
in the catalog accesses and no other job has the file open with 
Write permission, then an attempt to replace the named file/ 
catalog with the specified scratch file/catalog is made. 


T£ bit 4 (020000 octal, the escape convention bit) is set in X4, 
then all special scanning conventions are disallowed, and the 
replace will be trapped with a format error if the treename 
contains a special first name. The name and password of the 
file/catalog to be replaced cannot be specified with the "/" 
convention, and the replace will be trapped with a format error 
if that is attempted. For more information on tally operations, 
see Chapter 8. 
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The replacement will be made unless either the replacement would 
cause the catalcog's quotas to become exceeded, or the catalcog's 
quotas are already exceeded. If the catalog's quotas are already 
exceeded, then the replacement will be made only if the length of 
the scratch file or MAX of the scratch catalog is less than or 
equal to the length or MAX of the file/cataleg which it replaces. - 
Tf the MAX of the catalog is still exceeded after replacement, 
then Append permission will be removed fram the accesses 
available q@m the replaced file/catalcog. 


If the replacement is successful, then the file/catalog specified 
in X2 becames a cataloged file/catalog open with the accesses 
which were determined to be available, and the catalog entry is 
correspondingly updated. If the replacement was unsuccessful, 
then the file/catalog remains a scratch file/catalog and the 
catalog entry remains unchanged. 


A job which attempts to replace a file/catalog first has its 
catalog word allotment decremented by the length of the scratch 
file or of the scratch catalog header. If the replacement 
succeeds, then this allotment is incremented by the length of the 
file or header of the catalog which was replaced. If the 
replacement does not. succeed, then this allotment is incremented 
by the amount of the original debit. 


A file may not be replaced by a catalog, nor may a catalcg be 
replaced by a file. Replacement of a cataloged file/catalog does 
not affect the name, password, or access word in the catalog 
entry. The replacement scratch file/catalog must not have been 
passed to the issuing jod with the return bit set. 


On completion of the es a trap cecurs to the location 
specified in x6. If the file/catalog was replaced successfully, 
then the access bits cbtained are returned in bits 0~8 of status 
word 1, the new file reference number of the replaced file/ 
catalog in bits 18-35 of status word 1, and the length of the 
file or the MAX of the catalog in status word 2. 


In addition to the access bits returned in status word 1 of the 
trap, nine user access bits can be obtained by issuing a REQUEST 
STATUS. These user access bits are obtained fram bits 27-35 of 
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the replaced file/catalog's access word if the file/catalog was 
opened with a password. If the file/catalog was opened without a 
password or if it was protected by a trap program, the user 
access bits are obtained from bits 9-17 of the access word. 


If the command was unsuccessful, then status word 1 contains the 
reason for the failure. If the status is 12 or 40 or greater, 
the two words pointed to by X5 are undefined. If the status was 
7 (fetch error) then the two words are cleared. Otherwise, the 
last file name scanned is placed in the two words. (These words 
need not be aligned on a even-word boundary.) If the status 
returned from the replace is 12 (format error), then status word 
2 will contain a substatus, and a tally count and character 
position pointing to the character where the format error was 
detected. See Chapter 8 for more information on format errors. 


Status Returns 


0. Successful: the file/catalog was replaced and is now 
open with the accesses in bits 0-8. 


Ht Partial success: the file/catalog was replaced and is 
now open with the accesses in bits 0-8. Append 
permission has been masked off since the searched 
catalog's MAX is exceeded. 


2 Lockout: the cataloged file/catalog is currently in 
use with Write permission. 


3 The desired file/catalog was not found in the searched 
catalog. 


4 Protection violation: Search permissicn was available 
on sane catalog and the password specified for the next 
file/catalog was wrong. 


5 Unsuccessful: one of the Read, Write, or Append 
permissions was not allowed. 


6 Bad treename: Search permission was available on same 
intermediate catalog and the next entry in the treename 
was not the last entry, but was the name of a file 
rather than a catalog. 
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Fetch error: either 


(1) An error of type 3, 4, 5, and 6 cccurred and 
Search permission was not available on the catalog 
in which the search was being performed; or 


(2) Search permission was not available on the (N-l)st 
catalog and Fetch permission was not available on 
the file/catalog. 


REPLACE disallowed: the named file/catalcg is a device 
file. 


Format error: see Chapter 8 for possible types of 
errors. 


Quotas exceeded: either 


(1) The length of the scratch file or catalog header 
exceeds the job's remaining catalog word 
allotment, or 


(2) The specified catalog's MAX is exceeded, and the 
length of the scratch file or MAX of the scratch 
catalog is greater than the length or MAX of the 


file/catalog to be replaced. 
Out of storage: either 
(1) The Executive's table of opened files is full, or 


(2) A new entry had to be made in the catalog for the 
replacement and either 


(a) The catalog already had 4095 entries; 

(b) The Executive could not allocate sufficient 
storage for a required extension of the 
catalog; or 

(c) & is not possible to append to the catalog 


Since it either is a core catalog or is 
already allocated in twelve fragments. 
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Access error: the initial catalog to search is not 
open with Search permission; bits 0-8 of status word 1- 
contain the missing permission bit. 


Busy: another operation is outstanding on either the 
catalcg or the scratch file/catalog. 


XO parameter error: X0 does not contain the file 
reference number of a catalog. 


Xl parameter error: the pointer to the tally word is 
out of bounds. 


X2 parameter error: either 


(1) 2 dees not contain the file reference number of a 
scratch file/catalog; 


(2) The scratch file/catalog was passed to the issuing . 
jod with the return bit set; 


(3) The type of the scratch file/catalceg does not 
match the type of the file/catalog it is to 
replace; or 


(4) The scratch file had a preference of 0, 1, 2, or 4 
- and can only replace a file in a core catalog... 


X3 parameter error: X3 is nonzero and does not contain 
the file reference number of a catalog. 


X4 parameter error: bits 0-3 or 5-8 of X4 were 
nonzero. 


X5 parameter error: XS pointed to a two-word pair 
which was cut of bounds. 


X7 parameter error: X7 was nonzero. 


Recoverable error: an error occurred in reading the 
catalog. 


Unrecoverable error: information in an catalog has 
been destroyed. 
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MME 500107: TRUNCATE 


XO File reference number of file 
X6 Trap location 


A Length 


The file specified in X0, which must be open with Write and 
Append permissions, is truncated to the length specified in the 
A-register. If the file's read/write pointer points beyond the 
new end of the file, it is reset to point to the end of the file. 
Upon completion of the command, a trap occurs to the location 
specified in X6. 


A TRUNCATE command issued at the slave end of a communication 
file will generate a special interrupt number 14 (slave end 
issued TRUNCATE) at the master end. The second word of the 
special interrupt will contain the length specified in the 
A-register. If the communication file is busy, either because 
another end has an operation outstanding on it, or because 
another end has reserved it, the slave end issuing the TRUNCATE 
command will be trapped with a status of 6. If the job at the 
master end of a cammunication file is not accepting special 
interrupts when a slave end issues a TRUNCATE, then that slave 
end will be trapped with a status of 7. A TRUNCATE command 
cannot be issued on the master end of a communication file. 


A jcb which truncates a scratch (cataloged) file will have its 
scratch (catalog) word allotment incremented by the number of 
words truncated from the file. . 


Status Returns 
0 Successful: the file was truncated to the specified 


length. 


1 Unsuccessful: the specified length is longer than the 
current length of the file. 
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Comminication file busy: the communication file at 
whose slave end this command was issued is busy because 
another end has an operation outstanding on it or has 
reserved it. 


The master end of the communication file at whose slave 
end this command was issued is not accepting special 
interrupts. 


Status was reset on the TRUNCATE. 


Access error: the file is not open with Append and 
Write permissions; bits 0-8 of status word 1 contain 
the missing access bits. 


Busy: another cammand is outstanding on the file to be 
truncated. 


XO parameter error: XO is zero and does not contain a 
valid file reference number, or contains the file 
reference number of a device, job, or master cammnica- 
tion file. 
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MME 500104: UNCATALCG 


XO File reference number of cataloged file/catalog 


X6 Trap location 


The cataloged file/catalog, which must be open with Read, Write, 
‘and Append permissions, becomes a scratch file/catalog with Owner 
and eXecute/Searcn permissions added to its accesses if not 
already present. The catalog entry for the uncataloged file/ 
catalog is destroyed. Upon completion of the commard, a trap 
occurs to the location specified in X6. 


A job which successfully uncatalogs a file/catalog has its 
scratch word allotment decremented by the length of the file or 
of the catalog header. At the same time its catalog word 
allotment is incremented by this amount plus the length of the 
catalog entry. 


Status Returns 


) Successful. 
Z The file/catalog is not cataloged. 


40 Quotas exceeded: uncataloeging the file/catalog would 
cause the job's remaining scratch word allotment to be 
exceeded. 


100 Access error: the file/catalcog is not open with Read, 
Write, and Append permissions; the missing permission 
bits are set in bits 0-8 of status word l. 


120 Busy: another command is outstanding on the file/ 
catalog. 


200 XO parameter error: X0 does not contain te file 


reference number of a cataloged file/catalog, is zero, 
or is the file reference number of a device file. 
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400 Recoverable error: an error occurred in reading the 
catalog. 


420 Unrecoverable error: information in the catalog has 
been destroyed. 
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MME 500134: WRITE 


Xl Points to pointer to memory location Ml (may not be zero) 
X2. File reference number of destination file (may not be zero) 
X4 Flag bits 

X6 Trap location 


X7 ~=6©Points to number of words N to write into destination file 


N words starting at memory location Ml are written into the 
destination file, starting at the current location of that file's 
read/write pointer. Write permission is required on the 
destination file if the write will alter any existing data in the 
destination file, and append permission is required if the write 
will make the destination file longer. If the end of the issuing 
job's storage is reached, an end-of-file condition cccurs and 
data transmission stops. If any of the words transferred to the 
destination file are outside the range of that file, and the file 
is not opened with Append permission, an end-of-file condition 
cccurs and data transmission stops. Upon completion of the copy, 
a trap occurs to the location specified in x6, and the read/write 
pointer for the destination file is updated to point to the word 
beyond the last one written. 


A WRITE issued at the slave end of a communication file will 
generate a special interrupt number 12 (slave end issued WRIT) 
at the master end. The second interrupt word will contain the 
length of the WRITE. No data will be transferred until the 
master end issues a corresponding READ or COPY. (See the 
description of communication files in Section 5.1.) If the ccm- 
munication file is busy, either because another erd has an 
operation outstanding on it, or because another end has reserved 
it, the slave end issuing the WRITE command will be trapred with 
a status of 6. If the job at the master end of a communication 
file is not accepting special interrupts, the slave end issuing 
the WRITE command will be trapoed with a status of 7. 
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The flag bits in X4 have the following meanings: 


Bit Function — 
0-8 Currently unassigned. Must be zero. 
9 Must be zero unless X2 contains the file reference 


number of a master communication file. In that 
case, the corresponding slave end will be trapped 
only if a nonzero status return cccurs or if this 
bit is zero. 


10 Must be zero unless X2 contains the file reference 
number of a slave communication file or snared 
file. In that case, the communication file or 
shared file will be reserved for the end issuing 
the WRITE if this bit is one. Otherwise it will 
be released. 


11-17 Must be zero. 


Upon initiation of a WRITE command into a scratch (cataloged) 
file which is open with Append permission, the job's scratch 
(catalog) word allotment is decremented by the amount by which 
the destination file may be extended. Upon completion of the 
WRITE command the job's scratch (catalog) word allotment is 
incremented by the number of words charged to this allotment but 
not appended to the destination file. | 


If the status return in status word 1 is not between 100 and 360 
on completion of the WRITE cammand, then status word 2 contains 
the difference between the number of words transferred and the 
number of words requested (i.e. it contains minus the number of 
words mot transferred). If the status in word 1 is between 100 
and 360, then status word 2 is zero. If the destination file is 
a device file, then the lower half of status word 1 contains the 
status return from that device. 


The cdservant reader will notice that the WRITE command is 
treated as a special case of the COPY command in which both x0 
and X3 are assumed to contain zeros. 
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Status Returns 
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Successful: all words were transferred. 


Source file exhausted: some words were requested but 
not transferred from main memory, since the end of the 
issuing job's storage was reached. 


Destination file exhausted: some words were not 
transferred because the destination file was full and 
was not open with Append permission. 


Command inappropriate: the WRITE was issued at the 
master end of a cammunication file without having a 
corresponding READ command outstanding at a slave end 
of that file. 


The source file pointer is out of bounds: either, 
(1) The pointer was initially out of bounds; 


(2) A MEMORY RECUEST released job storage involved in 
the write; or 


(3) An attempt was made to write. fran the pure region 
of a job file which was swapped out of main 
memory. 


The destination file pointer is out of bounds: either, 
(1) The pointer was initially out of bounds; 


(2) The other end of a communication file issued a 
MEMORY REQUEST which released job storage involved 
in the writs; or 


(3) An attempt was made to write into the pure region 
' Of a jod file which was swapved out of main 
memory. 


The communication file at whose slave end this command 
was issued is busy, either because another end has an 
Operation outstanding, or because another end has 
reserved the communication file. 
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The master end of the communication file at whose slave 
end this cammand was issued is net accepting special 
interrupts. 


Status was reset on the WRITE command. 


Quotas exceeded: it was possible for the WRITE command | 
to exceed the job's remaining scratch or catalog word 
allotment; no words were transferred. 


Out of storage: the Executive could not allocate 
sufficient storage for a required extension of the 
destination file. 


Access error: the destination file is not open with 
the necessary Write or Append permission. Bits 0-8 of 
status word 1 contain the missing permission bits. 7 


Busy: another operation is outstanding on the 
destination file. 

Xl parameter error: Xl is zero or points to an 
cut-of-bounds location. 


X2 parameter error: X2 does not contain the file 
reference number of a file. 


X4 parameter error: X4 contains invalid flag bits. 
X7 parameter error: X7 points out of bounds. 


Recoverable error: an error occurred during trans- 
mission of data. The lower half of status word l 
contains the status from the device which generated the 
error. This return can cccur if a device file is being 
written via a communications file and the issuing job 
is swapped out of main memory. 
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Communication Files 


A communication file is a pseudofile which allows direct 
communication between jobs. A ccammunication file has a master 
end and one or more slave ends. Each end appears similar to an. 
Ordinary file. It has a file reference number which may be used 
aS a parameter for certain Executive calls, principally the COPY 
command. Other calls which may be used with communication files 
are DRIVE, PASS, CLOSE, REQUEST STATUS, RESET STATUS, TRUNCATE 
(or SCRATCH), and SET FOINTER. 


This chapter describes how these operations affect ccmmunication 
files and explains other features related to cammunication files. 
An extended example can be found at the end of the chapter. 


5.1 COPY Commands 


The COPY command and its variants, READ and WRITE, are used to 
perform the primary function of cammunication files: the direct 
transfer of data between jobs. Generally speaking, data which is 
copied "into” one emd can be copied "out of" the other end. Data 
transfer is always initiated at a slave end, and takes place 
between that slave end and the master end. 


5.1.1 Slave End COPY Commands 


A COPY. cemmand involving a slave end of a communication file may 
be issued at any time that the communication file is not busy 
(see Section 5.5), and uses the same format as a COPY canard 
involving aly ordinary files (see COPY MME). Besides the 
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restrictions normally imposed on the COPY cammand, the following 
must be odserved: 


(1) If the COPY source file (specified in x0) is an end (either 
master or slave) of a communication file, the COPY. 
destination file (specified in X2) may not be. In other 
words, only one communication file end may be specified as a. 
parameter for a given COPY cammand. 


(2) If the other file involved in the COPY is a device file (see 
Chapter 6), then the ultimate source or destination of the 
data must be main memory. Since this is determined by the 
job at the master end of the communication file independ- 
ently of any action which the slave end job can take, it is 
not recommended that COPY commands be attempted between 
device and communication files. 


When the slave end issues a COPY command, the job holding the 
Master end is notified by a special interrupt of its action. 
(See "Special Interrupts", Section 1.4.2). Data transfer dces 
not take place until the master end issues a corresponding COPY 
command. It should be noted, therefore, that COPY command 
operations issued at the slave end of a communication file may 
take a comparatively long time to complete. If the master end 
job is not accepting special interrupts, no COPY commands are 
possible q@ the communication file. Any attempts are rejected 
with the status of “other end not accepting specials" (7). 


The total length of data transferred (barring other errors) is 
the lesser of that requested at the slave end and that requested 
at the master. The end requesting "tco many” words is trapped 
with the status "source exhausted" (1) or "destination exhausted" 
(2), aS appropriate (unless the master end job exercises the 
"no-trap" cption — see below). This means that these statuses 
need not have their normal meaning on communication file COPY 
commands. On an ordinary file, these statuses would mean that 
further READ or WRITE commands are futile; however, they may 
represent normal and expected returns on communication file 
operations. 
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2.1.2 Master End COPY Commands 


As noted above, a COPY command may only be issued at the master 
end after the job at that end has been notified by a special 
interrupt that a COPY has been issued at a slave end. It is 
imperative that the job holding the master end be accepting 
special interrupts (have a valid, nonzero, special interrupt 
tally word — see Section 1.3). If it is not, all COPY cammands 
at slave ends will be rejected with the status of "other. end not 
accepting specials” (7). 


When the master end job receives a special interrupt indicating 
“slave. issued READ" (a job requested data transfer from a slave 
end of the communication file), it should issue a COPY (or WRITE) 
command transferring data to the master end. Similarly, in 
response to a "slave issued WRITE" special, it shculd issue a 
read-type command. (Types of special interrupts are described in 
Section 1.4.8). The same restrictions which apply to slave end 
copies also apply to the master end. That is, only one of the 
files specified in a COPY command may be an erd of a communica- 
tion file, and copies between a device file and communication 
file should not be attempted. The previous remarks on the 
source-exhausted and destination-exhausted statuses also apply to 
the master end. However, since the length requested by the slave 
end is contained in the special interrupt pair, it should always 
be possible for the master end jcb to predict the file-exhausted 
statuses. 


When copying to or from the master end of a communication file, a 
File pointer should not be specified (Xl or X3 should be zero). 
This is because the slave end job has already completely 
specified the destination or source of the data to be copied 
through the communication file. If a file pointer is specified, 
it will be checked for validity and then ignored. 


Once the master end job has received the special interrupt, it 
must eventually issue the corresponding COPY command, unless it 
resets status on the master end (see Section 5.5). Any other 
operation on the master end (except REQUEST STATUS) will be 
rejected as "inapprooriate” until the COPY cammand is issued. 
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5.1.3 The "No-Trap" Option 


When the master end job issues its COPY command, the usual action 
taken by the Executive is to transfer the requested data and then 
to trap the COPY at both ends (master ard slave) involved. The 
communication file then reverts to an idle or reserved state, 
depending on the option selected by the slave end job (see 
Section 5.4). However, when the master end COPY command is 
issued, the "no-trap" option may be specified by setting the 
appropriate flag bit in X4 (see COPY MME). In this case, when 
the data has been transferred, and if the master end status is 
"successful" (0), the slave end job is not trapped. Instead, the 
Slave end COPY remains outstanding and more master end COPY 
commands may be issued to satisfy any part of the slave end's 
request that was not fulfilled by a previous COPY. If the status 
presented at the master end is not "successful", the slave end is 
trapped as if the option had not been specified. In other words, 
the option has no effect in this case. The no-trap option allows 
the master end job to satisfy the slave end's request ina 
Piecemeal fashion. For an example of the use of the no-trap 
opticn, see Section 5.6. . 


5.2 Non-COPY Commands. 


Communication files are temporary entities, existing only as long 
as the master end and at least one slave end exist. If either 

. the master end or all slave ends are closed, the communication 
file disappears. Thus the file reference number of an end of a 
communication file is an invalid parameter for many Executive 
calls dealing with the catalog structure, such as OPEN, ERASE, 
CATALOG, Or REPLACE. Intended for cammunication, the ends of 
communication files cannot be "run". An attempt to do so will 
result in a parameter error status. Many other Executive calls 
are similarly restricted to files other than communication files. 
Those commands which can be used with communication files are 
discussed here. 
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5.2.1 REQUEST STATUS (Master End) 


A REQUEST STATUS can be issued to the master end of a ccmmunica- 
tion file, and will produce the same four-word status block as 
for an ordinary file (see REQUEST STATUS MME). The type field of 
the status block will indicate master cammunication file. 
However, the other fields (access, preference, length, pointer) 
are used by the Executive to maintain the current state of the 
communication file and will frequently contain meaningless 
information. Under certain circumstances, however, useful 
information may be extracted from these fields. 


The two high-order user access bits (bits 9 and 10) are used to 
indicate when a slave end has issued a COPY (to which the master 
end has not yet responded). BSCW (bit 9) will be on if (and only 
if) a slave end has issued a write-type command. BSCR (bit 10) 
will be @m if a slave end has issued a read-type command. in 
either case, the preference, length, and pointer fields will 
reflect the state of the file at the far end of the communication 
file; i.e. the other file involved in the slave end jop'’s COPY. 


5.2.2 REQUEST STATUS (Slave End) 


A REQUEST STATUS to the slave end is treated quits differently. 
It is essentially a variant of the READ command. When the slave 
end job issues it, a "Slave issued request status” special 
interrupt is generated at the master end job to write complete 
status information to the master end. This information is 
presented to the slave end job as its status block, and no status. 
information is provided by the Executive. No checks are made on 
the format of this information, and the master end job can write 
whatever it wishes. However, system convention dictates that the 
first three words of status information should correspond in 
format to the status block provided by the Executive for an 
ordinary file (see REQUEST STATUS MME) and should show a tyre of 
slave communication file. The master end job writes status 
information with a COPY or WRITE command, exactly as if the slave 
end job had issued a READ command. It may exercise the no-trap 
option if it desires. 
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5.2.3 DRIVE (Master End) 


Data transfer may not be requested at the master end of a 
communication file without prior action at a slave end. It is 
sometimes desirable to allow the master end job to initiate a 
chain of events involving the communication file, and the DRIVE 
comnand can be used for this purpose. When the master end job 
issues a DRIVE, a special interrupt is generated at a slave er. 
(The selection of the slave end to receive the special, in cases 
where more than one slave end exists, is discussed below.) The 
type of special interrupt is determined by the drive type given 
in bits 0-17 of the A-register on the DRIVE command. The valid 
DRIVE types at the master end of a communication file are: 


(1) "Read communication file" drive: A drive of tyre 1 (and the 
corresponding special interrupt) is conventially used by the ~ 
master end job to signal a slave end job that the master end 
job has data which the slave end should read. The master 
end job may not simply write directly into the communication 
file, since only a slave end may initiate data transfers. 
When the drive is issued, a special interrupt is given to a 
job holding a slave end. If the communication file is not 
reserved to any slave end (see Section 5.4), the special is 
given to the lowest job which holds a slave end and which is 
accepting specials (see Section 1.4). If a slave end has 
the file reserved, the special must be given to the job 
holding that end, or not at all. If no jod meets these 
criteria, the master end job has its DRIVE trapped with a 
Status of “other end not accepting specials" (7). 


(2) "Break" drive: A drive of type 3. (and the corresponding 
special interrupt) is conventionally used to notify a slave 
end job of same sort of "panic-stop" condition. Its most 
typical use is with a terminal communication file, to 
indicate the receipt of a break signal from the terminal. 
Since one of the intended purposes of this drive is to 
request the termination of runaway slave jobs by a higher 
job in the tree, this drive is treated specially by the 
Executive. If no slave end has reserved the communication 
file, the special is given to the lowest job in the job tree 
which holds a slave end, which is accepting specials, and 
which has eXecute ("break") permission on its end of the 
communication file. If a slave end has reserved the file, 


Page 180 Pub. 1059 


5 ~ COMMUNICATICN FILES 


the special is given to the lowest job meeting all these 
conditions, and which is also not lower than the job nolding 
the reserving end. Thus if the job holding the reserving 
end meets all the other qualifications, it will receive the 
special. If no job can be found meeting these criteria, no 
special interrupt will be given, and the DRIVE ccmmand is 
trapped with the status of "other end not accepting 
specials" (7). 


If a special is given to a job holding a slave end of a 
communication file due to a drive issued at. the master end, then 
the communication file will autcmatically be reserved to that 
job. 


5.2.4 DRIVE (Slave End) 


Certain drive types may be issued at a slave end of a communi- 
cation file to generate special interrupts at the master end job. 
In particular, a set mode drive (type 0) or a device drive (type 
12) may be issued. (Only these types are legal.) The two drives. 
will generate the corresponding special interrupts (set mode and 
slave-issued drive) at the job nolding the master end. If the 
master end job is not accepting specials, the DRIVE will be 
trapped with the status of "other end not accepting specials” 
(7). A set mode drive is conventionally used to specify 
directions for the handling of data to be transferred through the 
communication file. For terminal communication files in 
particular, it is used to set input and output medes (see DRIVE 
MME). The exact interpretation of a "set mode" special interrupt 
among the jobs holding ends of the communication file is a matter 
of convention. Device drives are not normally used on communica- 
tion files but are permitted by the Executive. © 


5.2.5 TRUNCATE, SCRATCH, and SET FOINTER (Slave End Only) 


These commands may be issued to a slave end and will generate 
special interrupts at the master end job, notifying it of the 
action at the slave end. When a slave end jcb issues a TRUNCATE 
to the slave end, a "slave-issued truncate” special is generated. 
When the slave end job issues a SET POINTER, a "Slave-issued set 
Pointer" special is given to the master end job. A SCRATCH 
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issued to a slave end generates a "slave-issued truncate" special 
specifying a length of zero. As with DRIVE, the "other end not 
accepting specials" status (7) can cccur. When issued to a slave 
end, these commands will release the reservation on the 
comminication file, if it was reserved to the end at which the 
command was issued. (See also Section 5.4.) These commands have 
no other effect on the file, and it is the responsibility of the 
master end job to take any appropriate action upon receipt of the 
special interrupt. 


5.2.6 PASS and CLOSE 


These commands are the means by which communication files are 
reated and destroyed, and additional slave ends are added and 
lost. A complete description of the use of these commands with) 

communication files is given in Section 5.3. 


5.2./ RESET STATUS 


Since several jobs can be affecting or attempting to affect the 
state of a communication file, the business of maintaining that 
state, and consequently of resetting it, becomes rather 
complicated. Section 5.5 is devoted to explaining the various 
possible states of a communication file and the role of RESET 
STATUS in modifying its state. 


5.3 Creation and Destruction 


A communication file is initially created by a create-type PASS 
command (or by the implicit PASS available in the RUN command). 

A communication file will be created for a job which issues a 
PASS specifying a file reference number of zero to be passed, and 
which turns on the communication file bit (bit 1) in the access © 
to pass. The file reference number returned to the passing job 
in the trap of the PASS (or in the pass list of a RUN command) is 
the file reference of the master end. This end cannot be passed; 
it remains with the job which created it until the communication 
file is destroyed. The job to which the PASS is issued receives 
the file reference number of a slave end in a "passed file” 
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special interrupt (see types of special interrupts in Section 
L438): 


The master end is always allowed all significant access 
permissions. The slave end is allowed whatever accesses are 
specified in the PASS cammand. These accesses need not include 
"Dreak" (eXecute) permission; if they do not, however, the master 
end job will never be able to issue a break drive successfully. 


Once created, a slave end may be passed, subject to the 
restrictions which govern the passing of an ordinary file (see 
PASS MME). I£ a slave end is passed without the return bit set 
in the accesses, it becomes permanently unavailable to the 
passing job (as is the case with an ordinary file). Its file 
reference number at the passing job becomes invalid and may ke 
reassigned by the Executive to the next file wnich the job opens 
or receives via a PASS. Unlike an ordinary file, if a slave erd 
is passed with the return bit set, it does not become busy. 
Instead, the passing job may continue to use its slave end, and a 
new slave end is created for the job at the receiving end of the 
PASS. For this reason, a communication file may be passed more 
than once (via a PASS ccmmand or implicit PASS on a RUN) and have 
more than one slave end. Once a job has passed its slave end 
with the return bit set, it may not CLOSE or PASS it again until 
the newly created slave end is returned (i.e. closed by the 
receiving job). The ends of a communication file are linearly 
ordered from lowest (most recently created Link in the chain of 
passes) to highest (master end). 


Note that it follows that only the lowest slave end can be 
closed, since any higher slave ends have been passed, and cannot 
be closed until the passed end has been returned. When the 
lowest slave end is closed, if it has been passed to the closing 
job with the return bit (is not the highest slave end), that erd 
disappears. The job holding the next lowest slave erd is 
notified by a "returned file" special interrupt (if it is 
accepting specials) that the file has been returned. This 
process can take place even if other ends of the communication 
file are busy with data transfer or other cperations (see Section 
5.5). The creation or destruction of extra slave ends is a 
process local to the ends being created or destroyed and does not 
involve the communication file as a whole. 
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On the other hand, when the last remaining slave end has been 
closed, or when the master end is closed (if ever), the entire 
communication file is destroyed. Any ends that remain after the 
communication file is destroyed are changed to a special file 
type called a "non-file” (13), and the jobs holding these 
non-files are notified by fFile-closed special interrupts that the 
communication file has been closed. The file reference number of 
a non-file is an invalid parameter for any command except RESET 
STATUS or CLOSE. However, the file reference number is not freed | 
for reassignment until the job acknowledges the receipt of the 
special interrupt by closing the non-file. It is possible for 
both ends of a two-ended ccnmunication file to be closed 
sufficiently close together in time to be considered simulta- 
neous. In this case, no non-files are created, and no special 
interrupts are generated. Note that a job using ccmmunication 
files should be prepared to receive parameter errors on its 
commands, since the communication file can be destroyed by the 
jobs at the other ends at any time, leaving the job in question 
with a non-file. If the job is not accepting specials, this 
Parameter error could be the only indication that the communica- 
tion file no longer exists. 


5.4 Reserving the File . 


It is sometimes desirable for a job at one end of a communication 
file to caomlete a sequence of operations on the file without 
danger of interference from the other ends. For example, one 
Slave end job might wish to write a message to the master and 
then read a reply, without the possibility that another slave end 
might "sneak in” between its operations and read its reply from 
the master end. The process of reserving the communication file 
allows for uninterrupted sequences of operations. Either a slave 
end or the master end may reserve the file, but only one end can 
reserve it at any given time. Reservation by a slave end has the 
effect of locking out all other slave ends from the communication 
file. Only local operations (see Section 5.5) can be issued at 
the other slave ends. When the master end reserves the file, all 
Slave ends are locked out. 


Reservation is specified oy setting the appropriate flag bit when 
issuing those commands which allow cammunication files to be 
reserved. A slave end may reserve a communication file on a 
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COPY, READ, WRITE, or DRIVE command. The master end may reserve 
the file only with a RESET STATUS ccmmand. 


Once the file has been successfully reserved, it remains reserved 
until an operation is issued at the reserving end which dees not 

call for continued reservation. There are two exceptions to this 
rule, however: _ 


(1) If the master end resets status on the communication 
file, specifying that it wishes to reserve the file, 
then the slave end reservation, if any, is nullified. 


(2) If a break special is given to a slave end other than 
the currently reserved slave end (because a break drive 
was issued at the master end), then the current 
reservation is nullified and the communications file is 
reserved to the end receiving the break special. 


The actual reserving is specified by setting the appropriate flag 
bit in an index register. BSRSVS (bit 1) is used to reserve the 
file whose file reference number is in XO (the source file on 
copy-type commands), while BSRSVD (bit 10) is used to reserve the 
file whose file reference number is given in X2 (the destination 
file in copy-type commands. (See the MME descriptions for more 
details on formats for individual commands.) Any coeration which 
dees not explicitly specify reservation will release an existing 
reservation (by the same end), except that a REQUEST STATUS 
issued to the master end will not release an existing reserva~ 
eton. 


When a slave end has reserved the file, it appears busy to all 
other slave ends. Only local operations can be issued at the 
other slave ends. The master end is not restricted by a slave 
end reservation. When the master end has reserved the file, it 
appears busy to all slave ends. This gives the master end job 
the ability to "squelch" a runaway slave end joo. 


The routing of special interrupts is also affected by slave end 
reservations. This insures that slave ends which are locked out 
of the file do not receive special interrupts to which they are 
unable to respond. The routing algorithm is described in Section 
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5.2. The general rule is that if a slave end has reserved the 
communication file, special interrupts generated by the master 
end DRIVE commands will be given to the job holding that slave 
end, or not at all. The only exception is a break drive: in 
this case, if the reserving end does not have break permission, 
the break special "bounces" up the communication file until it 
finds a slave end which does have break permission. Thus a 
reserving slave end job is not only guaranteed that no other 
Slave end is stealing its data, but also that its special 
interrupts are not being led astray. 


SP Busy States and Reset Status 


Since many jobs may attempt to use a communication file at the 
same time, some restrictions are necessary with respect to which 
may do wnat to the file and when. The general rule governing the 
use of the communication file is that only one operation which 
involves the file as a whole may be in progress at one time. The 
“communication file busy" status (6) is a special status returned © 
to jobs which attempt to initiate operations on a communication 
File cm which another "whole-file” operation is in progress. 

This status is also returned if the file is reserved to another 
end. The regular “busy” parameter error status (120) is used 
only when the erd at which the operation is issued is busy; that 
is, another operation has been issued at the same end and has not 
yet been trapped. 


Thus there are two different concepts involved here: that of the 
communication file's being busy, and that of one of its ends' 
being busy. Most operations involve both the file and at least 
one of its ends; however, there are certain local operations 
which tie up only the end at which they are issued. There are 
cases in which the file can be busy without any of its ends being 
eek Local operations may be issued even if the file itself is 
usy. 


The state of the communication file, as it appears at any one 
end, depends on the operations which have been issued at that and 
at other erds. The function of the RESET STATUS command is 
always to force the end at which it is issued to be idle (not 
busy). It may have additional effects, depending on the state of 
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the communication file. These effects are discussed below, state 
by state, beginning with those presented to a slave end. 


5.5.1 Slave End States 


First, the file and the slave end may both be completely idle. 

In this state, any valid operation may be issued at the slave 
end. If a RESET STATUS is issued, it functions as a purely local 
operation. It has no effect and traps with gocd status. 


Second, the file may be reserved to this slave end, with the 
end's being idle. The file will thus appear busy ("communication 
file busy") to all other slave ends. Operations may be issued, 
however, at the master end. If no operations are issued at the 
master end, the file will apear idle to the reserving slave erd, 
and any valid operation may be issued. However, if the master 
end has an operation pending or has reserved the file, the file 
will appear busy to the slave erd, and only lccal operations may 
be issued. In either case, RESET STATUS functions as a local 
operation, with the additional effect of releasing the slave end 
reservation. It will not, however, change the file's ae state 
if it is busy due to the action of the master end. 


Third, a local operation may have been issued at the slave end. 
Local operations are RESET STATUS, PASS, and, if the end was 
passed with the return bit set, CLOSE. If the return bit is not 
set and if CLOSE is legal, then this is the only slave end. In 
this case, CLCSE causes the entire communication file to be 
destroyed. Thus it is not a local operation, and can only be 
issued when the file is not busy. (There is one exception to 
this rule — see below.) 


When a local operation has been issued, the slave end will be 
busy. The state of the file as a whole is immaterial to the 
“state perceived by this slave end. Local operations may be 
issued even if the file is busy or is reserved to another end, 
and do not cause the file to become busy. Neither PASS nor CLCSE 
can be reset. If a RESET STATUS is issued while a PASS is in 
progress, it will have no effect and will trap after the PASS 
command is complete. Once a CLOSE command has been issued, the 
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file reference number becomes invalid, so that no RESET STATUS 
can be issued... 


Fourth, the slave end may be idle, but the file may be reserved 
to another end or may have an outstanding operation initiated 
from another end. In this case, the file appears busy (“communi-_ 
cations file busy") to this end. Only local operations may be 
issued, except that a CLOSE may be issued at the last remaining 
Slave end whenever both it and the master end are idle, even if 
the file is reserved to the master end. A RESET STATUS is a 
purely local operation in this fourth case, and does not change 
the file's busy state, since this end is not responsible for its 
_ being busy. 


Fifth, the slave end may be busy because a drive-type operation 
(DRIVE, TRUNCATE, SCRATCH, or SET POINTER) has been issued at 
this end. In this case, the file itself will also be busy, and 
no operations except local ones may be issued at any other end. 
The operation may be reset by a RESET STATUS if the special 
interrupt has not already been given to the master end job. In 
any case the RESET STATUS will trap after the DRIVE has trapped. 
The status on the DRIVE will indicate if the special interrupt 
was given. Note that the DRIVE may also be reset by a RESET 
STATUS issued at the master end. If a RESET STATUS is issued at 
the slave end, any reservation specified in the DRIVE will be 
released. . 


Finally, the slave end may be busy because of a copy-type 
operation (COPY, READ, WRITE, or REQUEST STATUS) issued at this 
end. This also has the effect of locking out all other slave 
ends. The master end, of course, must issue the corresponding 
COPY command, unless it issues a RESET STATUS. The action of a 
RESET STATUS issued at the slave end depends upon whether the 
master end job has already issued that COPY. If it has, then 
both COPY commands (master and slave) are trapped with the 
"status was reset" status (20). Both ends become idle, as dees 
the communication file itself. Any reservation by the slave end 
is released. On the other hand, if the COPY cammand has not yet 
been issued at the master end, the master erd job is notified by 
a special interrupt ("Slave issued reset") that its COPY is no 
longer required. The slave end COPY is trapped, both ends become 
idle, and any reservation to the slave end is released; however, 
the file itself remains busy until an echoing RESET STATUS is 
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issued at the master end. No operations except local operations 
or CLOSE can be issued at any end until the master echoes the 
slave's RESET STATUS. This restriction is imposed to prevent the 
master end jcb from being confused by a barrage of special 
interrupts caused by slave end jobs issuing COPY and RESET STATUS 
commands in rapid succession. Thus, after a COPY has been 
issued, same positive action is.always necessary at the master 
end before the file is idle again. 


5.5.2 Master End States 


The situation is camplicated slightly at the master end by the 
fact that the master end can be reserved with a RESET STATUS 
command; however, it is correspondingly simplified by the fact 
that there is always exactly one master end of any given 
communication file. The states visible at the master end are 
discussed below. 


First, the master end and the file may both be idle. This will 
be the case even if a slave end has issued a local operation. In 
this state, the master end job may issue DRIVE, CLOSE, or REQUEST 
STATUS commands. A RESET STATUS may be issued but will have no 
effect unless it causes the file to be reserved to the master 
end. 


Second, the file may already be reserved to the master end. 
Unless the last remaining slave end has been closed, any 
operation may be issued at the master end which could ce issued 
if the file were completely idle. A RESET STATUS will have no 
effect other than to release the reservation, unless it specifies 
to continue it. 


A third case occurs when a local cperation has been issued at the 
master end. The only local operation which can be issued at the 
master end is REQUEST STATUS. The situation is similar toa 
lecal operation at a slave end; the master end becomes busy, but 
the state of the file itself is not affected. REQUEST STATUS at 
the master end cannot be reset. A RESET STATUS will trap after 
the REQUEST STATUS is complete with no effect other than 
reserving or releasing the file. A REQUEST STATUS issued at the 
master end will not release a reserved communication file. 
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Fourth, the master end and the communication file are both idle 
(from the master's point of view) but a slave end has reserved 
the file. From the master end, this is indistinguishable fram 
the case in which the file is campletely idle. A RESET STATUS at 
the master end has no effect on slave reservations unless it 
specifies to reserve the file to the master end, in which case 
the slave reservation is nullified. 


The fifth case arises when a slave end has issued a drive—type 
command but the special interrupt has not yet been given to the 
master end job. This is clearly a rather transitory state. In 
this case, the master end is idle, but the file is busy. No 
Operation can be issued at the master end except REQUEST STATUS 
or RESET STATUS. If issued in time, a RESET STATUS will prevent 
the special interrupt from occurring, and will cause the slave 
end DRIVE to be trapped with the "status was reset" status (20). 
Other than that, it has no effect other than possibly reserving | 
the file. The file will be idle after the special interrupt is 
given or the RESET STATUS traps, unless another operation is 
issued. 


A sixth posible state cccurs when a slave end COPY ccammand has 
been issued, but the master end is idle. In this case, all 
operations. other than the correct COPY response (except REQUEST 
STATUS, RESET STATUS) will be rejected as inappropriate. A RESET 
STATUS will cause. the slave COPY to be aborted and will return 
the file to an idle (or possibly reserved) state. (The slave end 
COPY will be trapped with the "status was reset” status.) 


Seventh, the master end may have issued an operation: either 
DRIVE, on its own initiative, or COPY, in response to a slave end 
copy-type cperation. In both cases, both the file and its master 
end are busy. A RESET STATUS will abort a COPY cammand ard 
return the master end and the file to an idle (or reserved) 
state. A master end DRIVE cannot be reset; a RESET STATUS will 
trap. after the DRIVE completes, reserving the file if specified. 


The case which has no real parallel to the slave end situation 
eccurs when the master end job has received a slave-issued reset 
special interrupt and has not yet echoed it. Although the master 
end is idle, no operation except CLOSE or REQUEST STATUS can be 
issued to that end before a RESET STATUS is issued. Other 
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commands will be rejected as being inappropriate. The RESET 
STATUS will return the file to an idle (or possibly reserved) 
state. 


Finally, when the master end issues a CLOSE, both it and the file 
become busy until all slave ends have been destroyed. The CLOSE 
then traps and the master end is destroyed. A RESET STATUS 
issued before the CLOSE traps will be rejected. 


5.6 Usage Example 


5.6.1 Creating a Communication File 


Suppose that job A has run job B, which has in turn has run job 
C. Our portion of the job tree thus looks like: 


[a | 


Job A now issues a PASS ccammand to jcb B, specifying a file 
reference number of zero (create-type PASS) and access bits for 
Read, Write, Append, eXecute ("break"), and communication file. 

A cammunication file is thus created. Job A receives the file 
reference number for the master end (suppose it is 5) in the trap 
of the PASS, and job B receives the file reference number of the 
Slave end (suppose it is 7) in a “passed file" special interrupt. 
The file is now idle. 
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5.6.2 REQUEST STATUS from a Slave End 


Upon receipt of the "passed file" special interrupt, suppose job 
B attempts to get more information about its new file by issuing 
a REQUEST STATUS. It therefore issues one to its file reference 
7 (the slave end), requesting ten words. A special interrupt 
(slave-issued read) is generated at job A, specifying a length of 
ten words and file reference number 5 (job A's end). (See 
Section 1.4 for a description of the format of a special 
interrupt.) Job A then issues a WRITE to file reference number 5 
(the master end) for four words, placing a standard status block 
in the first three words and a special identifying code in the 
last word. These four words are presented to job B as its status 
block. Job A's WRITE operation is trapped with a status of 
"successful" (0), since all the data that job A requested were 
transferred. But job B has its REQUEST STATUS trapped with a 
status of “source exhausted" (1), since only four of the ten 
words it requested were available. 


5.6.3 PASS at a Slave End 


Suppose now that upon examining the data received on its REQUEST 
STATUS, job B decides that job C should have the slave end. It 
therefore issues a PASS to job C, specifying file reference 
number 7 (its slave end) and access bits for Read, Write, Append, 
and break. By not setting the return bit, job B effectively puts 
itself out of the picture for the duration of the communication 
file. Its file reference number 7 becomes invalid, and job C 
receives a passed file special interrupt specifying its file 
reference number for the slave end (suppose it is 3). 


Suppose job C immediately issues a RUN on a new job (job D, of 
course), specifying file reference number 3 as the first file in 
the pass list, with access bits for Read, Write, Append, and 
return. Jcb D is thus run with a slave emd as its file reference 
number 1. Since job C set the return bit, it retains its slave 
end (still its file reference number 3). The diagram now looks 
like: 
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FRN 5 (all accesses) 
Master End 


Communication 
File 


Slave End l 


return 
Slave End 2 (lowest) 


5.6.4 COPY Command with No-Trap Opticn | 


Job D now issues a COPY command from its storage to file 
reference number 1 for twenty words. A "slave-issued write” 
special interrupt is generated at job A specifying file reference 
number 5 and a length of twenty. Job A issues a READ for ten 
words, specifying the no-trap option by setting BSNTPS in the 
flag bits. The first ten words are then transferred fram job D's 
memory to job A's memory, and job A is trapped with the 
"successful" status (0). Job D is not trapped, since the master 
end job (job A) specified the no-trap option. 


Suppose job A now issues another ten-word READ, not specifying 
the mo-trap option. The last ten words are copied fram job D to 
job A, and both jobs are trapped with the "successful" status. 
The communication file is now idle again. 


Suppose job C shculd now happen to issue a COPY fram its file 
reference number 3 (a slave end of the ccmmunication file) to 
some other file (its file reference number 4, for example), for 
five words. Job A receives a "slave-issued read" special 
interrupt. If job A then issues a WRITE for ten words, 
specifying the no-trap option by setting BSNTPD in the flag bits, 
the first five words will be transferred fram job A's storage to 
job C's file reference number 4. Job C will then be trapped with 
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the "successful" status, while job A is trapped with the status 
"destination exhausted" (2). Note that the no-trap option had no 
effect, since the status presented at the master end was not 
"successful" (0). | 


5.6.5 Aborted COPY and Break Drive 


Suppose job D now issues a READ to file reference number 1. Job 
A is notified with a "slave-issued read" special interrupt. 
However, job A decides that a break drive should be given. It 
issues the DRIVE cammand. The drive is rejected with the 
“inappropriate™ status (3) because the slave end has issued a 
copy-type cammand. Job A therefore issues a RESET STATUS 
requesting the communication file to be reserved. Job D's READ 
is trapped with the "status was reset" status (20), and the file 
becomes reserved to the master end. If job D attempts to reissue. 
the READ, it will receive the "ccmmunication file busy” status 
(6). Job A now issues the break drive. Upon checking, the 
Executive discovers that job D dees not have break permission on 
its end of the communication file. If we suppose that job Cis | 
not accepting special interrupts, job A's DRIVE will be trapped 
with the status of “other end not accepting specials” (7). The 
file becomes idle, since job A's DRIVE had the effect of 
releasing its reservation. 


5.6.6 Slave End Reservation; Local Cperations 


Now consider what happens if job C issues a set mede drive 
requesting reservation of the file. Job A receives the special 
interrupt (set mode, type 0). The file is now reserved to the 
first slave end (at job C). , | 


Suppose job D now runs a new job (job E), passing it the slave 
end with the return bit set. It may not pass break permission, — 
since it does not have break permission to pass. The diagram is 
now: 
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FRN 5 (all accesses) 


Communication File 


Reservation 


FRN 1 (RWA, return) 
Slave End 2 


FRN 1 (RWA, return) 


Slave End 3 (lowest) 


Job D's implicit PASS is legal, since it is a lecal cperation. 
Any nonlocal operation attempted by job D would be rejected, 
Since the file is reserved to jcb C's erd. - 


Similarly, if job E now attempts to issue a REQUEST STATUS on the 
file it was just passed, it will receive the "ccmmunication file 
busy” status. 


If job A now issues a "read ccomminication file" drive, the 
special interrupt will be given to job C (assuming it is 
accepting specials). This will be true even if job E or Dis 
accepting specials, since the file is reserved to job C's erd. 
Suppose that job C, on receipt of the "read communication file” 
special, issues a READ command, not specifying reservation. The 
reservation is released, and the file becomes busy until job A 
issues the corresponding WRITE command. When it dees so, the 
data is transferred, and the file becomes idle. 
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5.6.7 Master End DRIVE 


Job A now issues another “read communication file” drive. Since 
no slave end has reserved the file, the Executive attempts to 
give the special interrupt to the lowest slave end (at job E). 
However, let's suppose that job E is not accepting specials. 
Therefore, the “read communication file" special interrupt will 
"bounce" up to job D. Assuming job D is accepting specials, it 
will receive the special interrupt. Note that the communication 
file is autcmatically reserved to job D now. If job C were to 
issue a READ command at this point, it would fail with the status 
"communication file busy” (6). 


5.6.8 Illegal Acticns 


Suppose job C now attempts to run a new job (this would be job F, 
presumably), passing it an end of the file (passing its file 
reference number 3). The RUN is rejected because, although jop 
C's end (file reference number 3) is not busy, it has already 
been passed and cannot be passed again until it is returned. 


Job A now issues a WRITE command to the master end. The WRITE is 
rejected with the "inappropriate" status, since no slave end has 
a READ outstanding. 


Job D now issues a READ command. This is legal. On receipt of 
the special interrupt (slave-issued read), job A issues a COPY 
from the slave end of a different communication file to file 
reference number 5 (our master erd). This is illegal, since only 
one of the files involved in a COPY may be the end of a 
communication file. The COPY is thus rejected, without affecting 
the state of the communication file. If job A now issues a CLCSE 
on the master end, it tco will be rejected, since job D's READ is 
Still outstanding. | 


Page 196 Pub. 1059 


5 — COMMUNICATICN FILES 


5.6.9 Destroying the File 


With the file in this fouled-up state, job A issues a RESET 
STATUS to clear out job D's READ and to reserve the file. It 
then issues a CLOSE. Before the Executive can process job A's 
CLOSE, suppose that job E also closes its end of the ccmmunica- 
tion file. Now things start happening. Job D receives a 
"returned file" special interrupt due to the closing of job E's 
end. This special is closely followed by a "file closed" special 
as its file reference number 1 is changed into a non-file by the 
master end CLOSE. Job C still holds a slave erd of the 
disappearing cammunication file. This end is changed to a 
non=file, and job C receives a "file closed" special interrupt. 
No more slave ends exist, so job A's CLOSE is trapped. Job A's — 
file reference number 5 becomes invalid. 


Jobs D and C are still left with non-files. Job D issues a CLOSE 
to its file reference number 1, and its non-file disappears. Job 
C, though, being a little slow to process its file-closed 
special, attempts to issue a set mode drive to what used to be 
its slave end (file reference number 3). The DRIVE is rejected 
with a parameter error status, since drives are not legal on 
non-files. Job C finally closes its file reference number 3, and 
the last trace of our cammunication file disappears from the 
system. 


5.6.10 Passing Back a Communication File 


Not included in this example is the capability to create a 
communication file for which the highest slave end is cvassed to 
the creating job's immediate supra job (PASSBACK). There is no 
operational difference, however, between this type of cammunica- 
tion file and communication files created in the normal manner. 


Note that since passing upward must be done when the communica~ 
tion file is created, the file may backtrack at most one level up 
the job tree. This and any subsequent passing of the created 
Slave end in the immediate supra job are otherwise subject to the 
rules associated with the PASS MME regarding normal cammunication 
files. 
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Device Files 


When a slave job wishes to access a peripheral it makes use of a 
device file. Device files exist for such peripherals as the 
terminal controllers and the high-speed printer. Device files 
are always of type 6 (special cataloged file). They are 
associated with nonallocatable devices. Since many devices have 
specialized functions which a slave mode program may wish to use, 
the DRIVE command with function code of 12 (single device action) 
or 24 (drive with DCW's) is provided for this purpose. A typical 
example is "rewind" on a magnetic tape handler. This chapter 
describes the special features and restrictions of device files, 
and special programming techniques used with them. 


6.1 General Information and Restrictions 


Currently, all device files are cataloged in :PERCAT, a direct. 
subcatalog of the master file directory. A slave job opens a 
device file in the same way as it would any other file in the 
catalog tree (see OPEN MME). This file reference number thus 
obtained can then be used as a parameter for a copy-type command 
in order to transfer data to or from the device, or for the DRIVE 
command to activate special functions of the device. 


Since device files reflect configured features of the hardware, | 
they cannot be created, destroyed or altered as can normal 
(allocated) files. Any attempt to use a special cataloged file 
as a parameter for a RUN, ERASE, UNCATALOG, TRUNCATE, SCRATCH, or 
REPLACE type command will be rejected. 
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Since all devices currently accessible as device files transfer 
data to or from a medium which is essentially external to the 
main computer system, the "length" of a device file is meaning- 
less. It will always appear as zero to a slave user. 


Because certain peripherals depend on the transfer of large 
records in a single physical operation (magnetic tape), or of 
records with a particular length (card equipment), the Executive 
is unable to guarantee that appropriate buffering will be 
available in master mode storage to copy between a device file 
and another noncore file. Thus, copy-type commands are 
restricted so that if one file in the copy is a nonallocatable 
device, the other must be a core file or a job file. In general 
a slave job will only transfer data between its own core (file 
reference number 0 on a copy-type command) and a device file. If 
a copy between a device and a noncore file is attempted, it will 
be rejected with a status of unrecoverable I/O error (420). 


In addition, if a job copying between its own core and a device 
file via a communication file should be swapped out of core 
before the copy can be initiated, the copy will not be able to 
proceed, and will be trapped with a status of recoverable I/0 
error (400). The copy must then be reissued. Note that in this 
case, the lower half of status return return word 1 will be Zero. 
This serves to distinguish fram the case in which an error 
occurred in the actual transfer of data. -_ 


4 


Tf a copy or drive with DCW's is successfully initiated between 
core and a device file, a section of the Executive concerned with 
physical device cperations is called. This section, called 
Physical I/O (PIO) will attempt to transfer exactly one physical 
record of data (whenever such a quantity is defined) for each 
COPY cemmand issued on a device file. Physical I/O can also ke 
called directly by the DRIVE ccmmand in order to request special 
functions or transfer more than one record to or from the device. 
Physical I/O prceduces a status word based on the queue word 
generated by the input-output multiplexer (ICOM) in the 
hardware-defined input-output sequence. The format of this 
status word is as follows: | 
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On a single device action DRIVE command this word is returned to 
the user in status return word 2 of the trap. On a copy-type 
command which involves device files or which results ina . 
recoverable error (status return 400), and on multirecord drives, 
the upper half of this word is returned in the lower half of 
status return word 1. The lower half is not returned in this 
case. 


The various fields of this word have the following meanings: 


SYNC BIT (Bit 0) — This bit is 1 whenever the status originated 
in the IM. If it is 0, the status was simulated by Physical 
T/O. Statuses simulated by Physical I/O are discussed below. 


POWER BIT (Bit 1) - If this is 1, the device in question is 
powered off. 


MAJOR STATUS (Bits 2-5) - This field contains the major device 
status provided by the hardware. Major status 12, 13 and 15 will 
cecur only on devices ccntrolled by a Microprogrammed Peripheral 
Controller (MFC). The general meanings of these statuses are: 


Q - Subsystem ready (good status) 
1 - Device busy | 
2- Device attention (This normally indicates that the. 


device is in an inoperable comdition which must be 
corrected by the computer operator.) 
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3 - Data alert (This normally indicates that some abnormal 
condition cccurred during the data transfer.) 


4 —- End-of-file condition 


5 - Command rejected (The peripheral subsystem did not 
accept the command.) | 


6 - Intermediate condition (specific to the type of device) 


7 - Timeout status (This status is simulated by Physical 
I/O when an operation has not campleted in a reasonable 
amount of time.) : 


10 - Channel busy. A hardware or Physical I/O error has 
occurred. 


12 - MPC Device attention (The MPC detected an inoperable 
device. This normally requires operator intervention 
to clear.) 


13 ~ MPC Data alert (The MPC detected an error in the data.) 


15 ~ MPC Command reject (The MPC could not precess the 
command .) | ; 


SUBSTATUS (Bits 6-11) - This field contains additional 
information about the operation just completed. It is specific 
both to the type of device and the major status. For formats and 
more details, consult the Honeywell peripheral subsystems manual 
for the specific type of peripheral or the Honeywell Gos I/0 
Programming manual, DB82. 


QUEUE ADDRESS (Bits 12-17) - This field contains the relative 
address of the interrupt queue word for this cperation, as it 
would be generated by an ICC (input-output controller). This 
field is normally not of interest to the slave user, with the 
following exception: A queue address between 40 and 57 (octal) 
represents a terminate interrupt, which is the normal way for 
most cCperations to complete. A queue address between 20 and 37 
(octal) represents an initiate interrupt, which usually indicates 
an error, except on operations such as rewind tape or console 
alarm which do not require the peripheral subsystem to become 
busy. A queue address of 0 should only occur when a status is. 
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Simulated by Physical I/O; other queue addresses should never 
Scour. 


IOM CHANNEL, STATUS (Bits 18-20) - This field represents the 
internal status of the ICM upon termination of the operation. A 
nonzero IOM Channel Status usually indicates an Executive or 
channel failure. The meaning of these ccdes is as follows: 


0 - No error 

1 - comnect while busy 

2 - illegal instruction 

3 - incorrect DCW 

4 ~- incemplete command sequence 

5 - not used 

6 —- parity error (peripheral to channel). 
7 - parity error (ICM central to channel) 


\ 


IOM CENTRAL STATUS (Bits. 21-23) - This field contains the status 
returned by IOM Central, which performs list service for the 
channels. A nonzero status in this field indicates an Executive 
failure. The status ccdes are: 


- No error 

- LOW tally runout 

Two TDCW's in a rew 

- LPWX boundary error 

~ TDOCW attempted to change address extension fran 
restricted mode 

~ IDCW encountered in restricted mede 

Character position incampatible with size 

- Parity. error fram channel 


m Wh fF © 
1 


SOV WI 
! 
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RETURN CODE (Bits 24-29) -— This code is generated by Physical 
I/O as a general summary of the result of the operation. Codes 
are: 


0 — Good; no error 

1 - Incomplete data transfer, but no error 

2 — End-of-file condition. This can cccur on 
magnetic tape or card reader. 

3 - Recoverable error 

4 ~ Unrecoverable error. Do not reissue the commard. 
5 ~ Timeout status. This is always a simulated 
status. 


RECORD COUNT RESIDUE (Bits 30-35) - This field has the number of 
records requested minus the number actually transferred. 


6.2 Device Drives 


A number of device operations do not fall into the READ/WRITS 
categories. These are invoked by the DRIVE cammand (see Chapter 
4). There are two kinds of device drives. Single action drives 
change the state of the device. Drives with DCW's transfer data 
to or from the device. Since drives are valid only for 
particular device types; the abbreviations below are used to 
indicate the device types for which a given operation is valid. 


Abbreviation Device 


Card Reader 

Card Punch 

Line Printer 

Magnetic Tape Handler 

Console Typewriter 

Datanet-30 

Micropregrammed Peripheral Controller 
Mass Storage Unit (Disk) 

Honeywell 716 Front End Processor 


ARSZORERR 
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6.2.1 Single Action Drives 


A single action drive has a code of 12 (octal) in the upper half 
of register A. The lower half contains an 18-bit MODE code, 
which identifies the operation to perform. These codes are: 


Mode 
070000 


070000 


100000 


110000 


140000 


150000 
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Description 


(MP) Reset MPC. Puts the MPC into an idle state. This 
sheuld be done before it is reloaded. 


(CN) Reset console. Any pending interrupts fram the 
console are cleared. 


(CR,CP,PR,MT) Await-Ready. Waits for the device to be 
in an operable condition, unless the device power is © 
off. Traps with a bad status if power is off. 


(CR,CP,PR,MP) Await-Special. Waits for a hardware 
special interrupt to occur on the channel to which the 
device is connected. As cpposed to the await-ready 
drive, this cammand will wait even if the device power 
if off. (Hardware special interrupts should not be 
confused with the software special interrupts returned 
to a Slave job at location 20.) 


(ALL) Enable Error Racauee: Sets normal error 
recovery mede so that any appropriate recovery 
procedures are attempted by the Executive when an error 
is detected. 


(ALL) Supress Error Recovery. Causes Physical I/O to 
treat any future statuses generated by the device as 
normal, and to pass them back to the caller immedi- 
ately, until an enable error recovery drive is set. 
This mode is intended only for the use of hardware test 
and diagnostic programs, and should be used with 
caution. Await-ready drives issued when this mede is 
set will trap whether the device is ready or not, since 
Physical I/O treats all statuses as ready. An ICM/MEM 
interface error detected while this mode is set will be 
returned to the caller with a return cede of 3 : 
(recoverable I/O error). 
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200000 


200000 


210000 


210000 


210000 


220000 


231000 


232000 


233000 


234000 


235000 


240000 


250000 


260000 


270000 


300000 


Page 206 


(ME) Set 6250 BPI. 


(CR,CP,MT) Set Binary Mcde. All subsequent copy-type 
commands will be done in binary mode. Status on this 
command is always simulated by Physical I/O. 


(H7) Set Normal Mode. I/O to the H716 will be done 
with normal Read and Write commands. 
(CR,CP,MT) Set Decimal or Mixed Mode. The inverse of 
set binary mode. 


(PR) Set BCD Mcde. BCD data is to be written to the 
printer. 

(H7) Set Dump Mode. Ifo to the H716 will be done with 
Forced Read and Forced Write commands. 


(MT) Set ASCII to EBCDIC Conversion Mode. On output 
data will be converted from ASCII to EBCDIC. On input 
data will be converted from EBCDIC to ASCII. 


(MT) Set 200 BPI. 


This can only be done on 7-track 
tape handlers. : 


(MT) Set 556 BPI. 


(MT) Set 800 BPI. 
(ME) Set 1600 BPT. 
tape handlers. 


This can only be done on 9-track 


This can only be done on certain 
9-track handlers. 


(MT) Set Default High Density. This is usually 800 
BPI. The value is set when the system is initialized. 


(MI) Set Default Low Density. This is usually 556 BPI. 
The value is set when the system is initialized. 


(PR) Set ASCII Mede. 
the printer. 


ASCII data is to be written to 


(MT). Set File Protect 


(MT) Forward Space Record 
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310000 (MT) Backspace Record 


320000 (MT) Forward Space File. An end-of-file return is, of 
course, normal on this drive. 


330000 (MT) Backspace File. The next read after this 
operation normally results in an end-of-file return. 


340000 (MT) Erase. This erases the tape. It should not be 
confused with the Executive ERASE command. 


340000 (CN) Alarm. This starts the console alarm ringing. 


350000 (MT) Write End-of-File. Writes a standard file mark 
character and end-of-file gap. On a 7-track tape this 
is 17(8). On a 9-track tape this is 23(8). 


3600cc (MT) Write Single Character. Writes a single-character 
record consisting of character cc. (This end-of-file 
record may be treated improperly by other computer 
systems.) 


370000 (MT) Rewind 


371000 (MT) Rewind and Unload. Both this and the rewind drive 
trap immediately on initiate interrupts. An 
await-ready drive can be issued if it is desired to 
wait until the tape finishes rewinding. 


6.2.2 Drive with DCW's 7): uy 


A Drive with DCWs has a drive type of in AU. .AL has the MODE. 
The record count (number of records tO transfer) is in bits 30-35 
of AL. This must be from l to 63, or zero which signifies a 
record count of 64. The number of IOTD's in the DCW list mist be 
at least as large as the record count. 
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The data control words (DCW's) pointed to by register Xl have the 
following format: 


Bits - Meaning 
0-17 Starting memory address to/from which to 
write/read 


18-21 © Must be zero 
22-23 Action code 
29-35 Word count 


The possible action codes are: 


Bits 22-23 Name Action 


00 | IOTD I/O Transfer and Disconnect.Transfer the 
number of words specified in the word 
count from/to main memory to/from the next 
physical record of the device. 


O1 IOTP I/O Transfer and Proceed.Transfer the 
number of words specified in the word 
count from/to main memory, then continue 
to the next DCW using the same physical 
record of the device. 


10 TDCW Transfer to DCW.The Executive will not 
allow use of this ccde. 


11 ICNTP I/O No Transfer and Proceed.Do not 
transfer the number of words specified. 


- Proceed to the next DCW. Data read will 
be discarded, data written will be zero. 


The valid drives of this type are: 


4100nn (CR) Multi-record Read. Reads nn records from the 
device. 


420001 (DS) Read Track Header. Reads the track header of 
' tne current track. 
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43x001 


61L00nn 


620001 
630001 


640001 


650001 


660001 


670001 
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(DS) Format Track. Formats the current track and 
writes the track header. The TI (track indicator) 
is set to x, which must be 0, l, 2, or 3. 


(PR) Multi-~record Write. Writes nn records to the 
device. 


(PR) Write Image. Loads the print train image. 


(PR) Write VFC. Loads the vertical format 
control. ; 


(MP) Load Control Store. Leads a microorogram 
into the MPC writeable control store. 


(MP) Load Main Memory. Writes the MPC main 
MeEMory .. 


(MP) Load Personality. Writes the MPC's 
personality overlay for a set of ports. 


(MP) Read Detail Status. Reads the detail status 
registers. 


In additicn, the following three codes are used internally by the 
Executive and may not be issued by a slave job, except indirectly 
by COPY cammands: 


- 400000 Read (all devices except CP,PR,MP) 
600000 Write. (all except CR,MP) 
700000 Diagnostics (all devices) 
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6.3 Device Status Returns 


This section describes the status returns a slave job can expect 
to get from a device file, on either COPY-type or DRIVE 
commands. | o 8 


The Major Status, which is four bits, numerically coded, is given 
in octal. The Minor Status (Substatus) is six bits, bit coded. 
Thus it is possible to get several Minor Status returns in one 
status. The Minor Status is given here in binary, where "x" 
means either 0 or l. 


More detailed explanations of device status returns can be found 
in the Honeywell Information Systems publication I/O Programming, 
order number DB86. 
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6.3.1 Console 


Major Minor 
Status Status Meani 


00 | channel ready 

02 device attention 

03 ‘ data alert 
oo00d1 transfer timing alert 
0x0010 transmission parity alert 
000100 . operator input alert 
001000 Operator distracted 
0100x0 incorrect format 
100000 message length alert 

05 _ cammand rejected 
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6.3.2 Card Reader 


Major 


Status Status 


00 


02 


03 


04 


05 


AZ 


13 


15 
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Minor 


000001 


000000 
xxxO0xl 
xxxO01lx« 
OxLOxx 
XlxOxx 
1x00xx 
ixixxx 


000001 


. 000x10 


0001x0 
001000 


000000 


001000 


001000 


Meaning 


Channel ready 


51 column cards 


device attention 


offline 
hopper/stacker alert 


Manual halt 


data 


feed alert 
card jam 

read alert 
sneak feed 


alert 

transfer timing alert 
validity alert 

dual read failure 


.hno read command 


| end of file 


logical end of file 


command rejected 


MPC device attention 


invalid punch 


MPC device data alert 


MPC command reject 


device reserved 
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6.3.3 Card Punch 


Major 


Status 


00 
02 


03 


05 
id 
13 


15 


Minor 


Status 


000000 
Osoxxx] 
Oxxx1x 


Oxxixx | 


Oxisxx 
Qlsoacx 


000000 
000xx1 


O0OxlLx 


000 lx 


000110 


001001 
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Meaning 
channel ready 


device attention 
offline 
hepper/stacker alert . 
manual halt 
chad box full 
feed failure 
card jam 


- data alert 


transfer timing alert 
transfer timing alert 
transmission parity alert 
punch alert 


command rejected 


MPC device attention 


MPC device data alert 
PSI data overflow 


MPC cammand reject 
device reserved 
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6.3.4 Printer 
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Major 


Status Status 


00 


02 


03 


05 


12 
a3 
15 


Minor 


000000 
000001 
000010 


-000011 


000100 
000101 
000110 
000111 


000000 
000001 
000010 
000100 
001000 


000000 


ooocdl 
000010 
000100 
001000 
010000 
1L0c000 


000000 
000001 
000010 
001000 
010000 
100000 


Meanin 


channel ready 


no button 

print one line 

forward space 

forward to top of page 
invalid line 
reverse/rewind 
backspace 

backspace to top of page 


device attention 


data 


power fault 
out of paper 
manual halt 
VFU tape alert 
check 


alert 


invalid character code/image 


buffer alert 
transfer timing alert 
alert before printing 
alert after printing 
paper low 
Slew alert 
top of page echo 


command reject 


VFC not loaded 

invalid op cede 

invalid device cede 
train image not loaded 
feed alert on last slew 


top of page echo on last slew 


MPC device attention 


MPC device data alert 


MPC cammand reject 
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643.5 Tape 
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Ma‘jor 
Status 


00 


Ol 


02 


03 


04 


05 


Minor 
Status 


 xxOxx) 


000x1x 
xxxlxx 
001100 
010x0x 
100x0x 


110x0x: 


000001 
000010 
000100 
100000 


“00xx01 


000010 


OxxlOx. 


Ox1lx0x 
Olxx00 


efefeterene 
000010 
xxxxll 
xxxixx 


000000 
Sena 
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Meaning 


channel ready 

no write ring 
at load point 
nine track 
ASCIT alert 
two-bit fill 
four—bit fill 
Six-bit fill 


device busy 
in rewind 
alternate channel in control 
loading | 
device reserved 


device attention 
no write ring 
no such handler 
handler in standby 
handler in check 
blank tape on write 


data alert 
transfer timing alert 
blank tape on read 
bit detected during erase 
transmission parity alert 
lateral parity alert 
longitudinal parity alert 
end of tape foil 


erd of file 
seven-track EOF 
nine—track EOF. 
data alert 
EOF character 


command reject 
invalid density 
invalid operation cede 
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xxxxlx invalid device code 
XXXLKx parity error on 
operation/device code 

001000 tape at load point 
010000 attempted read after write 
100000 nine—track alert | 

07 channel timeout 

10 channel busy 

12 MPC device attention 
O00coL configuration switch error. 
000010 multiple devices 
ooogodl1l illegal device ID number 
001000 incompatible mode 
OO01llxx TCA malfunction 
010000 MTH malfunction 
010001 multiple BOT 

13 MPC device data alert 
000001 transmission parity alert 
000010 inconsistent command 
000011 sum check error 
000100 byte locked out 
001000 PE-burst write error 
001001 - preamble error 
010000 multiple track error 
010001 skew error 
010010 postamble error 
010011 NRZI CCC error 
010100 code alert 
100000 Marginal capstan speed 

15 MPC command reject 
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6.3.6 Disk 
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Major 


Status 


00 


Ol 


02 


03 


04 - 


05 


10 


Minor 
Status 


0000xx 
001L0xx 


010000 


000000 
100000 


0000x1 
00001x 
001000 
010000 
100000 


elofelelene 


000010 — 


000100 
0x1000 
x1x000 
1x0000 


000000 
0000x1L 
0000lx 
000100 


001000 


010000 


001000 


6 — CREVICE FILES 


Meaning 


channel ready 


autematic retries 
in T&D 


EDAC correction 


device busy 


file positioning 
alternate channel in control 


device attention 


data 


write inhibit 
seek incomplete 
incperable 

in standby 
offline 


alert 

transfer timing alert 
transmission parity alert 
invalid seek. address 

header verification failure 
check character alert 

data compare alert 


end of file 


good track detected 

last consecutive blicck 

sector count limit 

defective track - 
alternate assigned 

defective track ~ no alternate 
assigned 

alternate track detected 


command reject 


invalid command sequence 


channel busy 
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000001 
000010 
000011 


000100 


001110 
010010 


010001 
010011 


010100 


010101 
010110 
010111 


- 011001 


011010 
011011 
011100 
011101 


MPC device data alert 


transmission parity alert 
inconsistent instruction 
sum check error 
byte locked out. 
EDAC parity error 
nonstandard sector size 
sector size error 
search alert on first search 
cyclic code error - 
not first search 
search alert - not first search 
syne byte error 
error in automatic alternate 
track 
EDAC - last sector 
EDAC - not last sector 
EDAC - block count limit 
EDAC - uncorrectable error 
short block 


; 
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6.3.7 Microprogrammed Peripheral Controller 
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Major 
Status 


00 
12 


i 


5 


Minor 
Status 


000001 
000011 
000010 
OOl1O11 
001100 
OO1LOL 
001110 


. Q00001 


000010 
000011 
000100 


000001 
000010 
000011 


000100 


Meaning 
channel ready 


MPC device attention 
configuration error 
device number error 
multiple devices 
CA OPI down 
alert EN1 unexpected interrupt 
CA ENL error 
CA alert - no interrupt 


MPC device data alert 
transmission parity 
inccensistent command 
checksum error 
byte locked out 


MPC command reject 
illegal procedure 
illegal legical channel number 
illegal legical channel 
to suspend controller 
continue bit not set 
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6.3.8 716 Front End Processor 


Major Minor 
Status Status Meaning. 


00 channel ready 
03 data alert 
000001 transfer timing error 
000010 improper buffer size 
_ 000100 transmission parity error 
05 command reject 
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6.4 Simulated Status Returns 


In addition to status returns generated by the ICM (sync bit 
equals 1), the following statuses will be simulated by Physical 
T/o. ad . 


Status 


000000 


000B00 
010000 
030400 
050100 


051000 


070000 


070100 


Pub.1059 


Word 


000000 


000300 


000400 


000400 


000400 


000300 


000500 


000500 


Status 


Ready. Simulate after a successful set 
decimal or set binary drive. 


Button status. Occurs only on line 
printer. B is the button number. See 
Section 6.5. 


Device Busy. Occurs only on diagnostic 
drives with queuing bypass option 
specified. 


Invalid address. The device address for 
the file is invalid. Usually indicates 
a hardware or Executive error. 


Invalid cperation. The cede is invalid 
for the device. Note that all codes are 
invalid for nonexistent devices. 


Invalid sequence. Occurs only on write 


commands to the Datanet-30. The 
Datanet-30 has issued a write-initiate, 
and the 635 slave program programmer 
mist respond with a read-type command. 


Channel Timeout. An cperation did not 
complete in a reasonable amount of time. 
This indicates a hardware or Executive 
failure. 


Special Timeout. Occurs on await- 
special and await-ready drives, and on 
reads to the Datanet-30. Indicates an 
excessive amount of time spent waiting 
for appropriate conditions (device 
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ready, special interrupt, or write- 
initiate from the Datanet-30) 


100000 000400 Channel Busy. All channels to the 
device have been released. 


200000 000400 Power off. The device is not con- 
, figured. 


6.5 Special Programming Considerations © 
Datanet~-30 


A write on a Datanet-30 file causes a write to be issued 
immediately. However, if a read is issued, Physical I/O delays 
until a special interrupt is received fran the Datanet-30 
channel, indicating the the Datanet-30 has issued a write, before 
issuing the read. If no special interrupt cccurs in a reasonable 
amount of time, the read commard is rejected with the simulated 
special interrupt timecut status. 


High-Speed Printer 


The user of the printer should be aware of the fact that 
top-of-page echo statuses are returned directly fran Physical I/O 
— the Executive does not retry operations with such statuses. 
Await-special, await-ready, and multirecord write drives may be 
issued to the printer. 


Tf the cperator presses one of the printer buttons, the printer 
returns device-attention/manual-halt status to subsequent write 
commands. When the OPERATE button is pressed, the printer 
rejects the next cammand with button status (cf. previcus 

- gecticon). Thus upon encountering a device-attention/manual-halt 
status, the preferred programming technique is to issue an 
await-ready command and inspect the status on the subsequent trap 
to determine the button number. The button numbers and labels 
are: 
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- PRINT ONE LINE 

- FORWARD SPACE 

~ FORWARD SPACE TOP OF PAGE 
INVALID LINE 

~ REVERSE/FREWIND 

- BACKSPACE 

— BACKSPACE TOP OF PAGE 


NOUS WD 
! 


A copy-type cammand generates a device command for the printer 
designed to print edited and slew one line after printing. Note 
that the slewing may be overridden by the appropriate use of 
escape and formatting characters. 


Disk 


The file pointer on a disk is the logical record number, not a 
physical record (sector) number. On a DSS190-tycre disk there are 
two physical records in a legical record. On a MSU450-type disk 
there are four physical records in a logical record. 


The FORMAT TRACK commands (MODE 43x001) format the track. 
containing the current sector. The Track Indicator bits are 
specified in the MODE and not in the file pointer. 


Card Punch — 


The card punch has the property that a card is not checked for 
punch errors until the subsequent card is being punched. Thus, a 
Slave jcb using the card punch should have the ability to repunch 
not only the current card, but also the previous card for error 
recovery in case of punch alerts. 


In decimal mode, cards are punched in the nonedit mode. 
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Card Reader 


The card reader can be operated in either binary or mixed mode. 
Each read issued on the device file causes one card to be read, 
except in the case of multirecord read drive (see DRIVE MME). An 
end-of-file return (return code of 2) will be generated by 
Physical I/O if an attempt to read a card is made when the hopper 
is empty and the LAST BATCH light is turned on. (Note that the 
last batch substatus is also returned on the trap of the READ 
command for the last card.) 


Magnetic Tape Handler 


Note that it is the user's responsibility to detect the 
end-of-tape foil status when writing tape. Note also that any 
Single character record will be treated as a file mark, but that 
octal 17 is the standard end-of-file mark on a 7-track tape, and. 
ectal 23 is on a 9-track tare. 


Await-ready and await-special drives may be issued to tape 
handlers. Note, however, that since all tape handlers may be 
connected to the same ICM channel, an await-special drive may 
trap whenever a hardware special interrupt is generated by any 
tape handler. Thus the recommended procedure for mounting a tape 
is to issue a rewind-standby drive, type a message to mount the 
proper tape, and then issue an await-ready drive. 


Console Typewriter 


Note that unlike the printer, the typewriter dces not halt data 
transfer on receiving an end-of-line sequence (escape character 
followed by a character of the form OXXXXX). Thus, more than one 
line can be written to the typewriter in a single WRITE. A 
carriage return is issued autcamatically after successful input; 
the user does not need to take this responsibility. 


Page 224 Pub. 1059 


6 ~- DEVICE FILES 


MPC 


The Reset operation on an MPC (MCDE 070000) normally results in a 
timeout. In this case a zero status is returned by Physical I/O. 


6.6 Executive Error Recovery 


If Executive error recovery is enabled, Physical I/O will attempt 
standard error recovery. The device status will be returned to 
the user only when the operation has succeeded , or if error 
recovery has failed. 


If a device status indicates a cordition of interest to the user, 
such as Top-of-page Echo on a printer, then no error recovery is 
attempted and the status is returned to the user. 


Standard error recovery includes retrying timeout status and all 
- IOM errors (nonzero ICM Channel Staus or ICM Cantral Status). 


Error recovery for the console includes printing "DELETED" and 
retrying ccerator input alert and operator distracted status. 
"LINE TOO LONG-—RETYPE IT" is printed in response to a message 
length alert, and the operation is retried. 


A data alert on tape is retried with backspace-reread or 
backspace-erase-write operations. The reread cperations are each 
tried up to eight times by the MFC. Up to seven reread 
operations are issued, with varying capstan speeds amd thresh- 
olds. Thus, a read operation may be tried up to 64 times. 


Tape movement errors are retried only if they returned an _ 
initiate status, that is, if the tape did not move. 
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Shared Files 


Files may ke open in one of two modes, normal and shared access. 

In normal mde, permissions are granted to various jobs such that 
only cne job may have a file open with append permission; or if a 
job has a file open with write permission, then only that job ney. 
access the file at all. 


In shared access mede, hcwever, any number of jobs may simulta- 
neously hold any combination of read and write permission. This 
mede allows separate jobs to update a common data base without 
closing and recpening the file between accesses. However, if any 
job has a file open in one mode (normal or shared), it may not be 
opened by another job in the other mcede. 


To cpen a file in shared mede, see TALLY OPEN. 


A file which is to be accessed in shared mode must be saved with 
the 'shared' bit turned on in the unpassworded accesses. (The 
shared bit is '040000' which is the same as the Owner bit for 
catalogs.) The bit will be ignored if it appears in the 
passworded accesses; when it appears on the unpassworded side it 
applies to opening the file with or without a password. This 
means there is no way to protect the permission to open a file in 
shared mode differently than the permission to open it in normal 
mode. Anyone who can open a file in shared mode can also open it 
in normal mode. Having Owner permission on a catalog dces not 
override the lack of the shared bit on a file in that catalog. 


COPY-type cperations to a file open in shared mede are queued and 
executed in the order in which they are received, except that 
reads may overlap each other. A job may lcck the file specifying 
oan no other jobs' operations may complete until the file is 
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unlocked, allowing that job to be sure that no changes will be 
made to the file for a certain interval and that no one will read 
inconsistent data. If another job has the file locked, the 
operation locking the file will not complete until the file is 
unlocked by the other job. 


Also note that shared mede files may act as a general inter-job 
semaphore. For example, a job may open a certain file in share 
mode, lock it to seize the semaphore and unlock it to release the 
semaphore. : . 


All COPY cperations will proceed normally in the order in which 
they are issued unless the Reserve bit is set in the flag bits in 
X4 ('200000' for scurce, '000200' for destination) of one of the 
operations. When this bit is specified, the file will be 
‘locked’ by or reserved to that job until the same job issues 
another copy operation without the bit set, or a RESET STATUS. 
While the file is reserved, other jobs’ operations will be queued 
and their execution will be delayed indefinitely until after the. 
file is released. A COPY operation involving a file open in 
shared mode may specify only the job's core as the other end of 
the COPY. Thus file-to-file or file-to-ccommunications file 
copies are not allowed. : 


Page 228 | Pub.1059 


Chapter 8 


Tally Operations 


The "Fetching" catalog cperations (OPEN, ERASE, REPLACE) provide 
two important utilities: 


(1) Allowing a job to access files in a catalog not 
accessible to the job, and 


(2) Providing a method to OPEN (ERASE, REPLACE) a file 
anywhere in the file system in one, indivisible, 
cCperation. | 


These cperations also unfortunately have two disadvantages: 


(1) The format of a treename is very inflexible, and 
not amenable to simple user interfaces, and 


(2) There are several "special conventions” which all 
jobs must therefore know about and (hopefully) 
handle identically. 


The "Tally" operations have been created to provide all the power 
of fetching operations with as much flexibility as possible. 
These operations use a standard treename format (defined in 
Section 8.2) so that all jobs can take advantage of this format 
without having to know anything about it. By creating these 
tally operations, all scanning and parsing is centralized. A job 
simply passes a tally (hence the name) which describes a string 
of ASCII characters to the Executive, and the Executive performs . 
all necessary parsing on the treename. 
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8.1 General Parameters 


The Tally operations are all built around one set of scanning 
routines in the Executive; because of this, they all have similar 
parameters. The only difference in calling parameters is in the 
specification of accesses. 


The general formats for the tally cperations are: 


X0 Contains the file reference number of the initial catalog to 
search 


Xl Contains a pointer to the tally word for the treename 
X3 Contains the file reference number of the "alternate initial 
catalog”. 
This catalog is used as the initial catalog to search when 
one of the three special conventions is used for the first. 
name in the treename (see Section 8.2). 
X4 Has me of three formats: 
(1) For TALLY ERASE and TALLY REPLACE: 
Bit 4 is the escape convention bit (see below). 
Bits 9-17 are the trap bit mask to be used during 
the Cpen phase of the operation. 
(2) For TALLY OPEN: 
Bits 0-3, 5-8 are the accesses with which to open 


the file/catalog. Bit 4 is the escape convention 
bit (see below). Bits 9-17 are the trap bit mask. 
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(3) For TALLY CATALCG: 


The register points to two words. The upper half 
of the first word is the same as (1) above, the 
lower half is zero. The secord word is the 
access word with which to save the file/catalog. 


X5 Is a pointer to two words (not neccessarily on an even-word 
boundary). This two word pair will contain the name of the 
file/catalog last scanned by the Executive (e.g. if the 
operation was successful, the last name in the treename), 
excepts 


(1) I£ the status was 12 (format error) or 40 or 
greater, the two words are undefined; or 


(2) If the status was 7 (fetch error) the two words. 
are zero. 


The "Escape Convention” bit (020000 octal) is provided to control © 
the use of the three special conventions explained in Section 

' 8.2. If this bit is zero, the Open phase of the operation will 
proceed as defined in Section 8.2. If this bit is one, then any 
attempt to use one of the special conventions will. trap the 
operation with a 12.7 status (see Section 8.3). 


8.2 Scanner Conventions 


The conventions to be used by the scanner are the following: A 
treename consists of one or more file/catalog names seperated by 
colons. Any of the names may have a password specified; the 
password is located after the name, separated from the name by a 
coma. For instance, | 


_ CATALOG]: CATALOG2 , PASSWORD : FILENAME 


is a legal treename. A name or password consists of 8 char- 
acters. Any name/password less than 8 characters will be left 
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justified and space filled to form a full 8 character quantity. 
In the past it was possible to cataleg files with non-standard 
names or passwords; a name/password in this case may be specified 
by a slash ("/") followed by up to 24 octal digits. These digits 
are then right justified and null filled to form a 72 bit 
quantity. To avoid future problems with non-standard treenames, 
any attempt to TALLY CATALOG or TALLY REPLACE a file/catalog with 
a name/password specified in octal will trap the operation with a 
12.10 status (see Section 8.3). 


Legal file/catalog name characters are: 


(1) all uppercase characters 


(2) all lowercase characters, which shall be converted 
to uppercase characters 


(3) all digits 


(4) and "=" and "." as special characters. 
Legal password characters are: 


(1) all legal filename characters 
(2) all control characters (oct 1-37). 
Any character which is not legal where found delimits the tree 


name string (all nulls are ignored), and will trap the operation 
with a 12.5 status (see Section 8.3). 


There are three special conventions for the first name of a 
treename. Use of a special convention when the escape special 
convention bit is on in the access word (see Section 8.1) will. 
trap the operation with a 12.7 status (see Section 8.3). 


The special conventions are: 
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(1) I£ the first name begins with a colon (:), the 
file or catalog is to be found in the MFD catalog 
specified by X3. A first name of ":MFD" is 
equivalent to a first word octal name of 
"/777777777777777777777777" “in the catalog 
specified by X3. 


(2) If the first name begins with a star ("*"), and is 
a legal user number format the scanner will expand 
the name to open a user catalog in the catalog 
"MUD" in the catalog specified by X3. If it is 
not a legal user number format, the operation will 
trap with a 12.2 status (see Section 8.3). 


Legal user number formats are: 


<C (*K — super group name) 
*ILC (*HDK — super group name) 
*CDD (*KOO — group name) 
*LLCDD (*HDKCO — group name) 


*CDDDDC (*40849%, — individual user numcer) 
*LLCDDDDC (*HDKCCOCO — individual user number) 


where: 

C = character which is a letter or digit. 
L = a letter 

D=a digit 


(3) If the first name contains a trailing "***", the 
file or catalog is to be found in "DLIBRARY" in 
the catalog specified by X3. 


Treenames are limited to 36 names. Any attempt to use a treename 
consisting of more than 36 catalog names (including any names 
prefixed by the scanner) will trap the operation with a 12.4 
status (see Section 8.3). 
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The following is a formal BNF definition of a treename: 


<treename> ::= <first name>:<names> 
| <first name>[<space> ... ] 


' <first name> ::= <name> 
: <name> 
<filename> *** [,<password>] 
*<:MUD name> [,<password>] 


<names> ::= <name>:<names> 
| <mame>[<space> ... ] 


<name> ::= <filename>[,<password>] 


<filename>. ::= { <filename character>} 
| /{<octal digit>} 


<filename character> ::= <©@® 
|  <special> 


<password> ::= {<password character>} 
/{<octal digit} 


<password character> ::= <@©® 
<special> 
<centrol character> 


<:MUD name> ::= <super group> 
<super group><D><D> 
<super group><D><D><D><D><C> 


<super group> a <L><L><@. 


<> 
<@© = <I> 
asic” (ABS DIRS E GIN 
iPi[q/Ri|s|tlolv|wlx|y|z} 
Pica elute sie 
<D> 3:5 (0]1]213/415]617/8 9} - 
<space> ::= {js} 
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<special> ::= {.|-} 

<octal digit> ::= {0/1]2]3]4|5]|6|7} 

<centrol character> ::= {<SOH|<STX>|<ETx>|<EOT>|<ENO>| 
<ACK> | <BEL> 


|  <BS>|<HT>| <LF>|<VT>|<FF>|<cR| 
<SO> | <SI> | <DLE> 

|  <DC1> | <DCc2>|<DCc3> | <DC4> | <NAK> | 
<SYN> | <ETB> 

| <CAN> | <Ex> | <SUB> | <ESC> | <Fs>| 
<GS> | <RS>| <uS>| } 


8.3 Status Returns © 


If the cperation was successful, then bits 9-17 of status word 1 
will be zero. The two words pointed to by X5 will contain the 
name of the file/catalog on which the operation was performed. 


Tf the cperation was unsuccessful, then status word 1 contains 
the reason for the failure. If the status is 12 or 40 or 
greater, the two words pointed to by X5 are undefined. If the 
status was 7 (fetch error) then the two words are cleared. 
Otherwise, the last file name scanned is placed in the two words. 


If the status returned from the operation is 12 (format error), 
then status word 2 will contain a tally count and character 
position in the lower half. When this lower half quantity is 
concatenated with the starting address of the string (the upper 
half of the initial tally word), the resulting tally will run out 
at the character where the format error was detected. In the 
upper half of status word 2 one of the following substatuses will 
be returned: . 


(1) Name too long: cannot be more than 8 characters 
nor more than 24 digits following a / in the "/" 
octal convention. 


(2) Illegal place for asterisk: an asterisk was 
found, and it was not the first character of the 
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treename nor a set of 3 at the end of the first 
name in the treename. 


(3) Tllegal format for name in ":MUD": the name 
following the leading "*" convention was not one 
of the proper formats. 


(4) Too many levels: the treename (perhaps expanded 
by the scanner) contains more than 36 catalog 
names, and is therefore tco long. 


(5) Illegal character: a delimiter was found before 
the tally ran out. A delimiter is any character 
which is not legal where it is found (e.g. a 
non-octal digit in a "/" octal specification). 


(6) Illegal format: every character in the treename 
was null, there was a null name, or there were no 
digits following a "/". 


(7) Illegal convention: a special convention was 
used, but the escape convention bit was set 
disallowing all special conventions. 


(10) Illegal use of "/" format: the final name or 


password in a TALLY CATALOG or a TALLY REPLACE 
cannot be specified using the "/" convention. 
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Catalog Structure 


9.1 Introduction 


This chapter describes some of the basic notions and subtle 
points of the catalog system. Catalogs are essentially ways. of 
organizing access to information which is external to any running 
Slave program. The catalog structure is generally drawn as a 
tree, with the Master File Directory (MFD) as the rceot, with 
files and catalogs contained in the MFD, with files and 
subcatalogs in turn saved in these subcatalogs and soon. Thus 
we see: 
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This chapter answers such questions as: what kinds of things can 
be files? What kind of information is kept about files? What do 
catalogs look like? How do storage quotas work? 


This chapter is divided into three parts: 


(1) The physical organization of files | 
(2) Catalog information accessible to slave jobs 


(3) Quotas and storage limitations 
9.2 Definitions 


A catalog is a collection of descriptors. Each descriptor 
describes some sort of object; the object may be a dis«x file, a 
catalog, a peripheral device such as a card reader, a core file, 
or cme of several other things. 


Each descriptor may be broken into two halves: one half contains. 
logical (device-independent) information, and the other specifies 
. where the object is stored by a list of device addresses (DA's). 
In general, the logical information may be viewed ard/or directly 
medified by slave programs, while the device addresses may not 
bey, - * 


There are only two types of descriptors: catalog descriptors and 
"file" descriptors. They are pictured below: 


Catalog Descriptor File Descriptor 
DA's 0 to 27 words 
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Both types have 8 words of-legical information. Catalog 
descriptors include exactly 1 word for DA's, while file 
descriptors may have frem 0 to 27 DA's apiece. 


The DA in a catalog descriptor points to the first part of the 
catalog it describes; this first part contains a catalog header 


which describes storage for that catalog. A catalog header looks 
like this: 


Catalog Header 


8 words 


12 words 


Objects may be either cataloged or scratch. An cbject is 
cataloged if a descriptor for it is included in scme catalog; 
otherwise it is a scratch object. Once an object is cataloged, 
it may mot be cataloged again, so objects created by slave 
programs are guaranteed to have only one descriptor apiece. 
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9.3 Physical Organization 
9.3.1 Device Addresses (DA's) 


A device address is a full word quantity specifying where part or 
all of an object can be found. The format of a normal DA is: - 


ia 17 18 35 


EXP -— log base 2 of the number of contiguous records in DA 
X - (not used). 
CC - logical Device Code (logical device number in ENV deck) 


RN -— Record Number of first record in DA 


(Although we refer to the DA as containing physical addresses, in 
fact the device cede and record number are internally mapped by 
the Executive into the true physical addresses; but this mapping 
does not concern us and we can consider these fields to be "true" 
physical addresses.) 


The device code ([C) is the most important part of a DA, for it 
specifies what kind of machinery the object is. Most cbijects are 
disk files or catalogs, so the device code reflects which disk 
drive their data is stored on. Peripherals such as printers, 
tape drives, card readers, and so on, all have their own device 
ccdes. 


The device code is the only part of an object's description which 
Specifies the physical type of the file. Since most slave jobs 
cannot look at DA's they cannot determine an object's physical 
type (whether it is a peripheral device, etc.) fram its 
description. They must copen it ard perform operations on it to 
deduce its type. 
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The EXP (size) field is only used for disk files and catalogs. 

It contains the log base 2 of the number of words in this DA, 
some or all of which are used to hold a chunk of the file or 
catalog. When the Executive allocates room for a file/catalog on 
a disk, it finds chunks of storage big enough to hold all the 
data. Each of these chunks is some power of 2 words lorg. The 
DA list, if read in order, contains the addresses of each chunk 
of the file in the proper order. 


If data is appended to the end of the file/catalog, the remaining 
unused space in the last DA is filled. When the last DA is 
completely filled, a new DA is allocated and appended to the end 
of the descriptor'’s DA list. Then data is written into that DA's 
space. 


Note that since file descriptors may hold no more than 27 DA's, 
files' sizes may be limited even though there is enough disk 
space to hold more data. The Executive's algorithm for 
allocating various sized DA's is designed to minimize this 
problem, but often has the side effect of reserving tco much 
space for files. 


This space is pericdically regained by the Shuffle medule which 
opens non-optimally allocated files, moves them into preallocated 
Scratch files, and then replaces the old files with the scratch 
files. When Shuffle opens each scratch file, it can tell the 
Executive how long the scratch file will be so that the Executive 
may optimally allocate DA's for it ard thus avoid wasted space. 
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The DA for a mass storage device file has the format: 


7S 17 18 f 35 


AT — Allocation Type (specifies logical to physical record 
mapping scheme) 


DC - Logical Device Code (specifies logical to physical 
record mapping scheme) . 


9.3.2 Catalogs 


A catalog is, as we have said, a list of descriptors of objects. 
Catalogs are always allocated on disks, and the 12 DA's in 
catalog descriptors serve as addresses to the various chunks of 
the catalog. (Naturally, not all 12 of the DA's need be used.) 
Two special catalogs, the MFD and SMOCORCAT, are allocated in 
core. 
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Storage management within catalogs works as follows. Assume the 
following picture of a catalog: 


header (20 words) 


entry 1 


(unused) 


"Holes" are created whenever objects are unsaved from catalogs. 
Holes are simple unused descriptors. When a new descriptor is 
added to a catalog, the Executive searches fram the beginning of 
the catalog to find the first hole big enough to put the 
descriptor in. If there are no holes big enough, the descriptor 
is added to the end of the catalog and the catalog's length is 
updated. 


Roughly the same thing happens when a file expands and needs a 
new DA in its descriptor. The descriptor is moved to the first 
hole big enough, or is added to the end of the catalog. 


Adjacent holes are never coalesced in a new, bigger hole. This 
is because the Executive maintains a table of open files, and 
this table contains the entry number of each file in its catalog. 
Entry numbers must include holes, or removing a descriptor from a 
catalog would change the entry numbers of an unknown number of 
open files in this table. For the same reason, holes may not be 
coalesced, or the entry numbers for all following descriptors 
would change. 
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Note that entries (holes and descriptors) are essentially 
- Maintained on a sequential list. Thus searches for a descriptor 
must proceed linearly through all entries until it is found. 


Finally, catalogs may contain no more than 4095 entries (holes 
and descriptors), due to the field size allocated for entry 
numbers in the Executive's table of all open files internal file 
table. 


Subcatalogs may be nested within catalogs an arbitrary number of 
levels deep (subject only to rules on storage quotas). 


9.4 Slave Accessible Information 


9.4.1 Catalog Headers 


Slave jobs may view a portion of each descriptor in a catalcg, 
and may odptain information about the catalog itself. The | 
information they may see includes information which governs 
access to the file, file identifiers, and so forth. This 
information is summarized below, in the forms in which it can be 
obtained by the "READ CATALOG" MME. 
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The zeroth entry returned on a READ CATALOG MME contains informa- 
tion about the catalog itself. This information is as below: 


PREF: bits 29-31; 
TYPE: bits 32-35 


MAX 


The maximum length which the catalog may hold. This maximum and 
its effects are described in detail in the section on catalog 
max's. 


ALCC 


The current length of all objects contained in the catalog plus 
20 words for the catalog header, plus 12 words for each file 
descriptor in the catalog. (Twelve is somewhat arbitrary, since 
file descriptors may range from 8 to 35 words long. It is chosen 
as a good average length.) : 


Every catalog contains a 20 word header describing the catalog, 
so the minimum ALOC for a catalog is 20 words. 
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The length of each file in the catalog is added into the ALCC; 
but each subcatalog has its MAX added into the ALCC. This means 
that changes to the lengths of files in subcatalogs do not affect 
the lengths of all catalogs containing the subcatalog. 


ACC 
The accesses with which the slave job has this catalog. cpen. 
PREF 


The catalog's preference. See the discussion of preferences 
below, under file descriptors. 


TYPE 
The file's type. Described below for file Descriptors. 
ENTRIES 


The number of entries (descriptors and holes) in the catalog. 
Jobs which want to read all the descriptors in a catalog should 
issue a Read Catalog MME for the number of entries, plus one. 
This guarantees that they will get them all. 


LEN 


The length of the catalog itself: 20 word header, descriptors, 
and holes. 
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9.4.2 Logical Descriptors 


Information about all objects saved in a catalog may be gained by 
applying a READ CATALOG MME to the catalog. The MME returns an 8 
word block for each descriptor; this descriptor is not in the 
same format.as the Executive maintains it internally, and does 
not provide the DA's in each descriptor. 


The DA's may be obtained by opening each object and applying a 
"PROVIDE DEVICE ADDRESS" MME to the object. Jcbs may only issue 
this MME if they are Load-Dump enabled, and so most jobs may not 
see an object's DA's. Since DA's are the only way to determine. 
peripheral types, etc., most jobs may not readily discover 
whether or not a given catalog contains peripherals. 


The descriptors (as returned by the READ CATALOG MME) look like 
this: 


PREF: bits 29-31; 
TYPE: bits 32-35 


NAME 


The name is a unique identifier for this descriptor, and hence 
for the object it represents. No two descriptors in a catalog 
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may have the same name, and the name is the only identification 
for a descriptor. : 


PASSWORD 


If a job supplies a password when trying to open (or erase, etc.) 
a file, the password is compared with this field, and no accesses 
are allowed if the password doesn't match. If the access word 
has the slave-trapped bit set, then this field contains the 
filename of a slave trap program (in the same catalog) to be run 
whenever some job attempts to open (erase, etc.) this file... 


If the file is master-trapped, the password field is irrelevant 
and may be used for arbitrary data. In any case, this field is 
returned as zero unless the job issuing the Read Catalog MME has 
owner permission on the catalog. See the publication "File 
Access and Protection” for help. 


ACC 


This word contains access bits, which are used to determine how 
various jobs, may handle the object associated with this 
descriptor. See TM102 ("File Accesses”) for an exhausting 
discussion. 


DAYS-USED 


The DAYS-USED field contains a count of how many different days 
the object associated with the descriptor has been used since it 
was last mdified. A file is "used" when it is opened. The day 
when the object was modified is not included in this count. 


Catalogs are never “used" but are medified by changing their — 
MAX's. 
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PREF 


An object's preference determines which storage class its storage 
is allocated from. In general, lowerSpreference files are saved 
so they are faster to access, but this is not an inherent 
property of preferences. They are simply a means of partitioning 
storage. The various preferences and how they are used are: 

Q - allocated in core 

1 - swap storage 

2 —- monitor scratch files, and files in :SMCORCAT 

3 - catalogs 

4 - normal scratch files 
5 - special data base 

6 — normal saved files 

7 - permanent data bases 
In general, if a file needs storage of same preference and none 


is available, it will be allocated storage fram the next higher 
preference which has rocm. 


Special permissions are required for jobs to open scratch files 
with preferences other than 4, or catalcged files with prefer- 
ences other than 5 or 6. These permissions are given to a job by 
the job which runs it, which must in turn have the permissions. 


All catalogs created by slave jobs are preference 3, no matter 
how the jobs create them. The Executive creates scme core 
catalogs with preference 0. 
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An cbject's type to a large extent determines what can be done to 
it. Only the types marked with a star below are possible for 
cataloged files: 
Q regular scratch file 
l regular scratch catalog 
*2 regular cataloged file 
*3 regular cataloged catalog 
4 special scratch file 


5 special scratch catalog 


*6 special cataloged file (device file) 
*7 special cataloged catalog | 
10 ccammimications file (slave) 
1lL communications file (master) 
12 running job 
13 nonexistant file (closed communications file). 
*14 migrated file 
16 shared mode file 
The difference between regular and special files/catalogs is that 
the DA's for regular files/catalcgs are drawn fram a system-wide 
pool, and storage for these files forms a part of the file 
system. Special files/catalogs have their own pre-allocated DA's 
which point to storage which is dedicated to these files or 
catalogs. Only the Executive can create special files/catalogs. 


Many operations such as ERASE, REPLACE, SCRATCH are not allowed 
on special files/catalogs. 
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At present, the MFD is the only specially-cataloged catalog. 
This, and the fact that its DLM is 00/00/00, serve as its only 
identification. 


Peripherals are saved as special cataloged files, since their 
DA's point to the devices themselves and are not suitable for use 
as file storage. The Executive makes a special check for special 
cataloged files, and does not update their lengths when data is 
written to them. (Thus tape drives do not get immensely long, 
for example.) Also, special cataloged files may not be unsaved 
or erased. Off-line descriptions contain no DA's and are fairly 
intractable, since the s they represent have moved to tape. 


DLU 


This field contains a coded form of the date last used. An 
object is “used” when it is opened, replaced, etc. The ceding 
format is the same as for the DIM. Catalogs are never “used” in 
this sense. 


DIM 


This field contains the coded form of the date the object was 
last modified. An cbject is modified when it is cataloged, its 
length changes, or when data is written to it. The DIM of a 
catalog is modified only when its max changes. 


bits O- 8 - year modulo 100 
9 - 12 - month (January = 1, December = 12) 
13 ~- 17 - day of the month : 


LENGTH (or MAX) 


If the descriptor is for a file, this field contains the file's 
length in words. I£ for a catalog, this field contains the 
catalog's MAX as described in the previous section. 
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9.5 Quotas and Storage Limitations 
9.5.1 Catalog quotas. 


A catalog's quotas are determined by the MAX word in its header. 
A catalog's MAX does not place any upper bound on its ALOCC 
(length of its included files and subcatalogs); rather it limits 
the accesses which jobs may obtain upon opening a file when the 
ALOCOMAX. That is, if a job can open a file with append | 
permission, it can write as much data into the file as it wants, 
limited only by the job's quotas (discussed in the next section). 


Three cases are notable for the relations between ALCC and MAX. 


(1) ALOC<MAX. A file may not be replaced if its new length 
would push the allccated length over the catalog's 
maximim. But if a job can open a file with apperd 
permission, the amount of data which it can apperd is 
limited only by its job quota. 


(2) ALOCMAX. Jobs may never get append permission on any 
objects within the catalog. Objects, however, may be 
replaced with objects of smaller lengths, or erased. 
(But not scratched, since scratching requires append 
permission!) . 


(3) ALOC (2*MAX). Files may not be opened. They may, 
however, be erased or replaced with smaller files. 


Jobs with special permissions may open scratch catalogs with 
infinite max's. Infinite max's are flagged with the sign bit in 
the MAX field set; quota checks are suspended for infinite max. 
catalogs. Such catalogs may only be cataloged within other 
infinite max catalogs, which then have the sign bit set in the 
ALOC field to signal an infinite length catalog. 


Note that scratch catalogs with infinite maxes may be cataloged 
within themselves, but may not then be cataloged elsewhere (Since 
already cataloged). 
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9.5.2 Job quotas 


To prevent jobs from running amok and filling all system storage 
with unnecessary data by appending to files, each job has a quota 
of how many words it may add to cataloged or scratch storage. 
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Index. 


Indexed words are given in their immediate context, i.e. as much 
to either side of the word as will fit on a line. Underlining 
has been amitted, all series of three or more spaces have been 
reduced to two, and each end-of-line has been made a space. The 
line number is calculated from the top of the page: the header 
line is always line 7, the trailer is always line 60, and line ll 
is usually the first line of text. 


Brackets are used to enclose entries for which the same wording 
will not be found in the text; no line number is given for these 
entries. 
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158 36 e trap, nine user access bits can be obtained by issuin 
127 54 on, the nine user access bits from 9-17 of the catalog | 
228 25 e bit is set in the flag bits in X4 ('200000' for sourc. 

69 53 ster end job. The flag bits in X4 are divided into tw 

75 26 status of 7. The flag bits in X4 have the following 
1i6 53 status of 7. The flag bits in X4 have the following 
141 49 rf that erd). The flag bits in X4 have the following 
172 ll tatus of 7. The flag bits in K4 have the following 

60 ll this word contains trap bits which the issuing job d 
193 54 tting BSNTPD in the flag bits, the first five words wil 
193 37 tting BSNTPS in the flag bits. The first ten words are 

87 [cemmunication file bit] 

iL. [communication file bit] 
158 [shared bit] 
192 . [return bit] 

50 lL Mme 500010: TIME SINCE BOOTLCAD No arguments’ The 

18 [bounced special interrupt] 

17 38 #£are either aieraeaed Or counced to a job higher in the 

18 24 special is discarded or "bounced", and the procedure 

19 20 cial interrupt cannot be bounced. If the job stops acc 
186 16 sion, the break special. “bounces” up the ccmmunication 

19 26 1 be discarded. 1.4.6 Bouncing Special Interrupts 
177 [bouncing special] 

186 [bouncing special] 
194 [bouncing special] 

20 54 Section 5.2.) 3 BRK Break - notifies a slave end j 
194 17 5.6.5 Aborted COPY and Break Drive Surcose job D no 
185 26 ved slave em (because a break drive was issued at th 
194 22 er, job A decides that a break drive should be given. 
183 19 never be able to issue a break drive successfully. On 
186 14 The qnly exception is a break drive: in this case, if 

74 [break drive] 

186 17 lave erd which does have break permission. Thus a rese 

74 [break rermission] 

191 [break permission] 

186 16 ve break permission, the break special "bounces" up the 

185 25 nullified. (2) If a break special is given toa sl 
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page line word 
74 [break special] 
183 18 cesses need not include "break" (eXecute) permission; i 
180 44 g specials" (7). (2) "Break" drive: A drive of type 
180 55 nd which has eXecute ("break") permission on its end 
175 54 ommunication file is not busy (see Section 5.5), and us 
44 39 . This file will remain busy as long as the PURE comma 
188 41 ily, the slave end may be busy because of a copy~type op 
87 23 y or which are currently busy cannot be passed to the n 
75 19 mmunication file that is busy due to the action of anot 
186 24 eing led astray. 5.5 Busy States and Reset Status 
187 31 le, the file will appear busy to the slave end, and onl 
141 42 use the master end to be busy until a RESET STATUS is i 
88 28 ully spawned job remains busy until a trap occurs to th 
112 26 «he return bit set become busy until they are closed and 
186 32 The “communication file busy” status (6) is a special 
187 26 usy ("communication file busy") to all other slave ends 
188 18 ("communi- cations file busy”) to this end. Only loca 
189 51 ; the master end becomes busy, but the state of the fil 
69 23 he communication file is busy, either because another e 
116 45 he communication file is busy, either because another e 
138 34 he communication file is busy, either because another e 
144 29 he communication file is busy, either because another e 
146 30 he communication file is busy, either because another e 
167 33 he communication file is busy, either because another e 
171 47 ccm munication file is busy, either because another e 
187 44 ued when the file is not busy. (There is one exception 
183 30 set, it does not become busy. Instead, the passing job 
13 15 de for a valid Executive call are always 101 to reduce 
12 17 #3 MME Faults; Executive Calls A slave job may reques 
12 38 nt interrupt. Trapping calls also function as transpa 
14 49 mally indicate Executive calls. However, if the job ge 
223. 40 t in the file pointer. Card Punch The card punch ha 
224 ll the nonedit mode. Card Reader The card reader 
Dos bE MME 500103: CATALOG xO File reference n 
120 il MME 500114: READ CATALOG x0 File reference n> 
148 lL MME 500141: TALLY CATALOG xX0 File reference n 
96 ll MME 500125: OLD READ CATALOG AND OPEN FILES x0 F 
96 32 command is like the READ CATALOG AND OPEN FILES command 
114 37 on them by issuing a READ CATALOG AND OPEN FILES command 
124 11. - MME 500127: READ CATALOG AND OPEN FILES xO F 
124 33 ication words The READ CATALOG AND OPEN FILES command 
86 15 (quotas exceeded). The catalog and scratch word allot 
fs \~ aa MME 500111: CHANGE CATALOG ENTRY x0 File refer 
62 ll MME 500124: CHANGE CATALOG MAX XO File referen 
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15 
21 
21 
33 
43 
28 


50 


46 
23 
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41 


“word 


ained by applying a READ CATALOG MME to the catalog. 


Pointed to by X5 of the CATALCG 
the lower half. See MME CATALCG 


64 files) 3. Special Catalog 
abled with the Special Catalog 
—-— tt Catalog 
llotment] [catalog 
ith its catalog entry. Catalog 
ations, see Chapter 8. Catalog 

[catalog 
[catalog 
[catalog 
[catalog 


age Limitations 9.5.1 Catalog 
's remaining scratch and catalog 
r. At the same time its catalog 
lso have its scratch and catalog 
{catalog 

(catalog quota = catalog 
le/catalog first has its catalog 
ng 0 Job's remaining catalog 
[catalog 

catalog header, and its catalcg 
SE command will have its catalog 
le/eatalog first has its catalog 
[catalog 

At the same time its catalog 
[catalog 

be obtained by the "READ CATAICG" 
sion, the job's scratch (catalceg) 
e will have its scratch (catalog) 
re, such as OPEN, ERASE, CATALCG, 
talcged only in a core catalog. 
pertaining to that file/catalcog. 
only specially-cataloged catalog. 
P . (3) For TALLY CATALCG: 
uence of commands ERASE, CATALOG; 


Il. 


lways o£ type 6 (special 
als are saved as special 
cutive creates scme core 
{core 

the slave connect fault 

ided into two-word fault 


catalog] 
cell) 


MME. 


T 
Upon completion 


or Chapter 9 for more 
permission (allows a j 
permission and is spec 


Quota 
quota 
quota 
quota 
quota 
quota 
quota 


5 en 
cataleg word a 
checks are suspe 
checks are suspe 
checks] 
checks] 
checks] 


quota checks] 


quotas 
word 


word 
word 
word 
word 
word 
word 
word 


‘word 


word 
word 
word 
word 
word 

MME: 


A catalog's q 
allotments are ad 


allotment is decr 
allotments increm 
allotment] 
allotment] 
allotment decreme 
allotment Log 
allotment] 


allotment is decr 
allotment increme 
allotment decreme 
allotment] 
allotment is incr 
allotment] 


word allotment is dec 
word allotment increm 


or REPLACE. 
13 Illegal usage 


Intended 


The information for 
This, and the fact th 
The register point 

however, the REPLACE 
FD is the only specially-cataloged catalog. This, and t 


cataloged file). 
cataloged files, since their D 
catalogs with preference 0. 


They are ass 


is. zero, a slave conne 


cells, one for each of the six 
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MME 500111: 

MME 500124: 
flow/truncate, or divide 
g entry. Catalog quota 
apter 8. Catalog quota 
[catalog quota 
[catalog quota 
[catalog quota 
[catalog quota 

MME 500014: 
et by the Executive call 
rrupt. 5.2.6 PASS and 

MME 500105: 
cept local operations or 
ord 2 on the trap of the 
turn bit set, it may not 
dle, no operation except 
been destroyed because a 
will become invalid (cf. 
the master end issues a 
end job may issue DRIVE, 
LLY OPEN, UNCATALOCG, and 
nds OPEN, UNCATALCG, and 
urned in the trap of the 
d except RESET STATUS or 
with the return bit set, 
passed. 6 FCLO File 


word 


CHANGE CATALCG ENTRY xO Fil 
CHANGE CATALOG MAX XO File 
check fault occurs, it is retu 
checks are suspended for the E 
checks are sla for the T 
checks] 

checks] 

checks] — 

checks] 

CLOCK A Time The CLOCK co 
CLOCK. Both these calls aren 
CLOSE These commands are the 
CLOSE XO File reference num 
CLOSE can be issued at any end 
CLOSE command will contain the 
CLOSE or PASS it again until t 
CLOSE or REQUEST STATUS can be 
CLOSE was issued at another 
CLOSE). Upon completion of t 
CLOSE, both it and the file be. 
CLOSE, or REQUEST STATUS comma 
CLOSE. A job which issues a- 
CLOSE. Upon completion of th. 
CLOSE. (See CLOSE.) A termin 
CLOSE. However, the file refe 
CLOSE. If the return bit isn 
closed ~ notifies the joo that 


les are notified by file-closed 
[returned closed 


special interrupts that 


special] © 


2 (lowest) 


sely followed by a "file closed" special as its file re 
nterrupt of type 6 (file closed) is generated at all ot 
[cede data] 
e second word contains a coded date used to initialize 
ter X5 does not point to coded dates, but contains a co 
[coded date] 
This field contains a coded form of the date last us. 
This field contains the coded form of the date the obj 
{read comm file drive] 
[read comm file special] 
detect a serious error. Command faults are generated w 
5.6.4 COPY Command with No-Trap Option 
on 5.6. 5.2 Non-COPY Commands Cammunication files 
the file appears busy ("commuini- cations file busy”) t 
from the slave end of a communica- tion file, and X1 


Pub. 1059 


page line word 
87 11 the access is 1, then a communication 
191 26 mple 5.6.1 Creating a Communication 
20 421 - mode. 1 RCF Read communication 
lll 52 cratch file, or create a communication 
19 30 d at the master end of a ccmmunication 
87 | [communication 
see [communication 
182 50 , and which turns on the communication 
186 32 gress at one time. The "cammunication 
187 25 will thus appear busy ("communication 
141 36 RESET STATUS issued on a communication 
64 34 If the master end of a cammunication 
144 28 (see TRUNCATE). If the cammunication 
74 36 nication file are 0 (set communication 
74 27 may be issued only on a communication 
200 32 and a device file via a communication 
69 17 sued at a slave end of a communication 
116 639 «ed at the slave end of a communication 
146 26 ed at the slave end of a communication 
167. 29 ed at the slave end of a communication 
171 41 ed at the slave end of a communication 
180 27 on file are: (1) “Read communication 
195 43 job A now issues a "read communication 
117 13 #&4xXsource file is a master ccammunication 
20 24 #=a DRIVE or CLOSE on a ccmmunication 
137 32 le or the slave end of a communication 
138 24 er of the slave end of a communication 
180 47 1 use is with a terminal camnication 
75 44 &2sSlave end of a terminal cammunication 
112 12 age can be passed with a communication 
172 20 nee number of a master camunication 
70 42 nd destination files are communication 
181 40 tion file. For terminal communication 
112 20 ob files, master ends of communication 
196 {destroying communication 
197 {destroying communication. 
18 26 ptona_e slave en ofa 
24 18 ually occurred, then the 
18 46 #£=°first word of the slave connect fault cell) 
15 34 tions The shutdown and 
li 35 in this category are all 
"225. 37 Error recovery for the 
224 43 an await-ready drive. Console Typewriter 
66 11. MME 500121: CCNTINUE 
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file 
File 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
File 
file 
file 
file 
file 


file" drive: 
File" 
file, 


will bec 

Suppose t 
- used ton 
and pass it 
are bounced 
bit] 
bit] 
bit (bit 1) 
busy” statu 
busy") to a 
for which a 
is closed, 
is busy, ei 
mede) and 1 
Or on a dev 
should be s 
will genera - 
will genera 
will genera 
will genera 
will genera 
A 
drive, the 

the corr 


file, the lower 


file, 
file, 
file, 
file. 
file. 
file. 
files 
files 


then the s 
then a spe 
to indic 
The drive 
If xO is 
In that 
is not all 
in particu 


files, and file/ 
files] 
files] 
communications file can be "ko 
connect fault (special interru 


is zero, 


connect fault cells have speci 
connect faults, timer runout £ 
console includes printing "DEL 


Note that 


XO File reference 
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running below it until a 


- @ the supra job's RUN or 


job in X4 of the RUN or 
the trap for the RUN or 
be restarted by another 
be continued by using a 
£ a recoverable error, a 
(3) On RUN, EXECUTE and 
b then has the option of 
ask and escape special 
: Bit 4 is the escape 
0000 [octal], the escape 
020000 octal, the escare 
020000 octal, the escape 
020000 octal, the escape 
are zero. The "Escape 
(bit 4) escape special 
(bit 4) escape special 
e specified with the "/" 
e specified with the "/” 
on 8.3). 8.2 Scanner 
hen all special scanning. 
hen all special scanning 
hen all special scanning 
There are three special 
one of the three special 
ere are several "special 
ial first name = special 
le for pure procedure. 
length. (See slave end 
permission. MME 500131: 
1" (0). 5.6.5 Aborted 
ion. Job D now issues a 
occurs when a slave end 


aS a special case of the 


as a special case of the 
End 2 (lowest) 5.6.4 
issue the corresponding 
Slave end via a WRITE or 
e calls, principally the 
5.1.1 Slave End 
5.1.2 Master End 


end. 
Ss 
Section 5.6. 


page line — 
141... .32 
109 45 
42 42 
48 29 
66 56 
88 40 
88 43 
29.. 35 
14 28 
156 23 
230 42 
148 40 
152. 41 
156 49 
162 46 
231..°33 
152 23 
162 23 
148 45 
162. 51 
231 42 
152 42 
156 50 
162. 47 
232 48 
230 34 
229 «40 
232 
44 52 
22 14 
68 lL 
194 17 
193) 32: 
190 34 
117 42 
Le. 239 
193: = 29 
Li? St 
138 30 
175 26 
175°. .49 
177 11 
178 36 
22 42 


location pointer (see 


COPY 


5.2 Non-COPY Commands 


word 


CONTINUE command is issued. 
CONTINUE command is trapped wi 
CONTINUE command which initiat 
CONTINUE command which initiat | 
CONTINUE command. If the job 
CONTINUE command. If, however 
CONTINUE may not be issued. [I 
CONTINUE, gives termination 
continuing or terminating the 
convention bit X5 Pointer to 
convention bit (see below). 
convention bit) is set in the 
convention bit) is set in x4, 
convention bit) is set in X4, 
convention bit) is set in X4, 
Convention" bit (020000 octal) 
convention, (bits 9-17) trap 5 
convention, (bits 9-17) trap b 
convention, and the catalog wi 
convention, and the replace wi 
Conventions The conventions 
conventions are disallowed, an 
conventions are disallowed, an 
conventions are disallowed, an 
conventions for the first name 
conventions is used for the fi 
conventions" which all . jobs 
convention] | [spec 
Copies to and from the pure re 
COPY cammands, Section 5.1.) 
XO File reference numb 
COPY and Break Drive Suppose 
COPY command from its storage 
COPY cammand has been issued, 
COPY cammand in which Xl and X 
COPY carmmand in which both x0 
COPY Command with No-Trap Opti 
COPY command, unless it resets . 


COPY command. In other words, 
COPY command. Other calls whi 
COPY Commands A COPY camnman 
COPY Commands As noted above 


Communication 


COPY MME). 1.4.9 Simultaneo 
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200 41 
179 51 
20 50 
190 44 
185 11 
188 42 
199 43 
201 23 
227 53 
171 45 
249 21 
57 17 
249 50 
242 
200 24 
238 31 
70 44 
38 28 
70 44 
69 11 
44 
68 
121 50 
126 45 
204 26 
149 18 
55 43 
38 42 
85 16 
191 26 
182 43 
183 53 
242 
241 17 
250 46 
251 17 
240 43 
222 25 
251 
37 
56 20 
96 41 
125). 22 
Pub. 1059 


the file is released. A COPY operation involving a fil 
transfer of data. If a copy or drive with DcwW's is su 
tatus information with a COPY or WRITE command, exactly 
ed a RESET STATUS on a COPY to which the master end 
n its own initiative, or COPY, in response to a slave e 
communication file on a COPY, READ, WRITE, or DRIVE co 
£ a copy-type operation (COPY, READ, WRITE, or REQUEST 
sed as a parameter for a copy-type command in order to 
ord 2 of the trap. On a copy-type command which involv 
file in that catalog. COPY-type cperations to a file 
a corresponding READ or COPY. (See the description of 
re: 0 - allocated in core 1 - swap storage Z 
y be cataloged only in acore catalog. 13 Illegal 
e cciaaaigica be Creates some core catalogs with preference 
[core catalog] 
ice, the aeice must be a core file or a job file. Ing 
such as a card reader, a core file, or one of several o 
(source) file must be a core file, the issuing job's c 
Ss scheduling only) 1 Core Residence permission 2 
file, the issuing job's core, or a communica- tion fil 
tion cannot be used with core, which has no implicit re 
[job core] 
[jeb core] | 
5 Upper: days-used count Lower: preference and 
5 Upper: days-used count Lower: preference and 
lated status. RECORD COUNT RESIDUE (Bits 30-35) -T 
set the file's days-used count; the lower half contains 
set the file's days-used counter (see Chapter 9). The 
y Scheduling (PDQ) 6 Crash (allows slave job to abo 
or, Priority Scheduling, Crash, and Log. The spawned j 
Usage Example 5.6.1 Creating a Communication File 
fying its state. 5.3 Creation and Destruction Ac 
(see Secticn 5.5). The creation or destruction of ext 
[DA = Device Address] 
er of 2 words long. The DA list, if read in order, con 
les/catalogs is that the DA's for regular files/catalog 
loged files, since their DA's point to the devices them 
most important part of a DA, for it specifies what kind 
ramming Considerations Datanet-30 A write on a Data 
[cede data] 


run down. MME 500004: DATE No arguments. DATE loa 


e used to set the file's Date Last Medified attribute. 
upper half and the coded date last modified in the lowe 
The date last used and date last modified in the cata 
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page line | word 
149 20 the upper half and ceded Date Last Modified in the lowe 
125 21 on specified in X6. The date last used and date last m 

56 18 to initialize the file's Date Last Used attribute. The 
149 20 nd word contains a coded Date Last Used in the upper ha 
121 [DLM = date of last modification] 

121 54 last use Lower: ccded date of last modification 7 

126 49 last use Lower: coded date of last modification 7 

121 53 alog 6 Upper: ccded date of last use Lower: cod 

126 48 alog 6 Upper: coded date of last use Lower: cod 
eden [DLU = date of last use] 

56 17 nd word contains a coded date used to initialize the fi 

56 22 is set to zero, and the date~last-used and date-last-m 
149 16 o -.two words of usage and dates information. The upper 

96 34 does not point to ceded dates, but contains a ceded da 
251 [ceded date] 

49 ll MME 500003: TIME OF DAY No arguments The ASCII 
248 42 exhausting discussion. DAYS-USED The DAYS-USED fiel 
121 50 ccess word 5 Upper: days-used count Lower: pref 
126 45 ccess word 5 Upper: days-used count Lcewer: obref 
149 18 r used to set the file's days-used count; the lower hal 

55 43s used to set the file's days-used counter (see Chapter 

77 34 atus word 2 centains the DCW residue of the last DCW ac 

rem [DCW residue] | 
207 41 ing. 6.2.2 Drive with CCW's A Drive with DCWs has. 

77 31 dout. If a DRIVE with DCW's fails with a bad DCW sta 
200 41 #£x°%If a copy or drive with CCW's is successfully initiate 

74 16 ontrol Words (Drive with DCW's only) xX4 Flag bits X6 
204 37 the device. Drives with DCW's transfer data to or from 
199 29 ction) or 24 (drive with Dcw's) is provided for this pu 
207. 51 #£The data control words (DCW's) pointed to by register. 

76 20 tion) and 24 (drive with DCW's). A drive of type 12 ap 

76 33 xr 6 for a description of DCWs. Status word 2 on a ccm 
187 43 communication file to be destroyed. Thus it is nota l 
196, }] {destroying communication files 
197 ] [destroying communication files 
182 43 te. 5.3 Creation and Destruction A communication 
183 53 n5.5). The-creation or destruction of extra slave erd 
201 22 29 30 35 Ona single device action DRIVE command th 

76 20 device files: 12 (single device action) and 24 (drive w 
199 28 ction code of 12 (single device action) or 24 (dryve wi 

74 36 ile mede) and 12 (single device action). These drives g 
114 26 The command causes the device address list for the sp 
247 22 and applying a "PROVIDE DEVICE ADDRESS" MME to the obj 

58 27 ff-line but the file has device addresses allocated ( 
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page line word 
114 il MME. 500126: PROVIDE DEVICE ADDRESSES X00 File re 
238 37 t is stored by a list of device addresses (DA's). In ge 
240 14 al Organization 9.3.1 Device Addresses (DA's) A de 

38 48 Xes, enables the PROVIDE DEVICE ADDRESSES ccmmand, and 
126 27 catalog 8-19 List of device addresses for catalog ( 

56 14 th them (zero length; no device addresses). The upper 
242 [DA = Device Address] 

240 31 (not used) DC — logical Device Code (logical device nu 
181 32 mode drive (type 0) or a device drive (type 12) may be 

76 36 completed single action device drive contains the stat 
204 31 Illy transferred. 6.2 Device Drives A number of de 
176 21 nvolved in the COPY is a device file (see Chapter 6), 
177 33 le, and copies between a device file and communication 
172 50 he destination file is a device file, then the lower ha 

74 28 mmunication file or on a device file. Drives on commun 
199 24 the high-speed printer. Device files are always of typ 

77 41 #42x.DRIVEs, see Chapter 6, "Device Files". Except as not 

76 19 wo valid drive types for device files: 12 (single devic. 

76 [device status returns] _ 

210 11 es) 6.3 Device Status Returns This s 
200 [device status word] 

92 53 1 contains the physical device status.. Status Retur 
237 29 ee, with the Master File Directory (MFD) as the root, w 
157. 15 ro, then the Master File Directory (MFD) is searched. 
101 20 ro, then the Master File Directory is searched. As eac 
199 40 taleg of the master file directory. A slave job opens 
233 [MPD = Master File Directory] | 

18 48 o fault takes place. No dirty fault vector aborts ar 

14 25 nonzero, the job had a "dirty fault vector" and is abo 

15 25 job to be aborted for a dirty fault vector. The simul 
223. 26 formatting characters. Disk The file pointer onad 

14 38 ), overflow/truncate, or divide check fault cccurs, it 
233 41 talog is to be found in "DLIBRARY" in the catalog spe 
247 46 E: bits 32-35 6 DW OM —————-—— 
251 35 "“used" in this sense. DIM This field contains the 
121 n] [DIM = date of last modificatio 
124 48 an or equal to the coded DIM in the lower half of the w 
251 26 nt-have moved to tape. DLU This field contains aco 
247 46 TYPE: bits 32-35 6 HU DMX -—_————--— 
121 [DLU = date of last use] 

124 51 anor equal to the coded DLU in the upper half of the w 
196. ll , 5.6.7 Master End DRIVE Job A now issues anoth 
194 17 Aborted COPY and Break Drive Suppose job D now issu 
yi: ns MME 500132: DRIVE x0 File reference num. 
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page line word . 
180 ll if it desires. 5.2.3 DRIVE (Master End) Data tran 
181 27 ed to that job. 5.2.4 DRIVE (Slave End) Certain dr 
181 32 ive (type 0) or a device drive (type 12) may be issued. 

29. 50" 3 12 D Slave issued drive - notifies the master 

74 {set mode drive = set mode special] 

19 29 which are generated by a DRIVE command at the master en © 
180 17 munication file, and the DRIVE command can be used for 
200 47 e called directly by the DRIVE command in order to requ 
201. 22 na single device action DRIVE command this word is ret 
199 44 m the device, or for the DRIVE command to activate spec 
199 28 ram may wish to use, the DRIVE command with function co 
194 23 be given. It issues the DRIVE command. The drive is r 

(185 11 a COPY, READ, WRITE, or DRIVE command. The master end 
181 41 ut and output modes (see DRIVE MME). The exact interpr 

20 13 pecials generated by a DRIVE on a communication file, 

20 23 ecial was generated by a DRIVE or CLOSE on a ccmmunic 
194 22 bA decides that a break drive should be given. It iss 
181 - [slave-issued drive special] . 

183 19 be able to issue a break drive successfully. Once cre 
207 41 shes rewinding. 6.2.2 Drive with DCW's. A Drive wit 
77 #31 ce was timed out. If a DRIVE with DCW's fails with a 
200 41 of data. If a copy or drive with DCW's is successful 
74 #16 r to Data Control Words (Drive with DCW's only) X4 FI 
199 29 le device action) or 24 (drive with DCW's) is provided 
76 20 e device action) and 24 (drive with DCW's). A drive of 
29 38 of infra job. (4) On DRIVE with DCW's, gives record 

181 35 et mode and slave-issued drive) at the job holding the 
189 34 master end job may issue DRIVE, CLOSE, or REQUEST STATU | 
190 44 ued an operation: either DRIVE, on its own initiative, 
175 28 ccmmunication files are DRIVE, PASS, CLOSE, REQUEST ST 
195 43 read communication file" drive, the special interrupt w 
188 28 a drive-type operation (DRIVE, TRUNCATE, SCRATCH, or S | 

20 56 eda break drive. (See DRIVE-master end, Section 5.2. | 

21 54 cammand (MOLE). (See DRIVE-slave end.) — 3 °R S 
190 20 a slave erd has issued a drive-type canmand but the spe | 
180 27 Read communication file” drive: A drive of type 1 (and 
180 44 als” (7). (2) "Break" drive: A drive of type 3 (and 
186 14 nly exception is a break drive: in this case, if the r> 
204 31 nsferred. 6.2 Device Drives. A number of device op. 
205°. Ut 6.2.1 Single Action Drives A single action drive 
204 36 e drives. Single action drives change the state of the 
204 37 he state of the device. Drives with DCW's transfer dat 
74 {set mode drive] 

74 [read comm file drive] 
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{break drive] 
[set mede drive] 

ver a memory, fault tag, DRL, lockup, illegal procedure 
uing the command is Load-Dump = enabled, (a) Appen 
ot enabled with the Load-Dump permission) The forma 
to usage and dates (Load-Dump enabled jobs only) or 2 
(4) If a jeb is Load-Dump enabled, and if X5 is non 
his MME if they are Load-Dump enabled, and so most jobs 
If the jod is not Load-Dump enabled, or if X5 is zero 
hg a catalog) 4 lLoad-Durp permission (allows preall 
job is enabled with Load-Dump permission and X7 is non- 
ob enabled with the Load-Dump permission will cause N w 
MME is enabled with Load-Dump permission, and if X5 is 
obs enabled for the Load-Dump permission. Nonenabled jo 
valid. MME 500143: DUPLICATE x0 File reference 
On OPEN, ALTER ACCESSES, DUPLICATE, and REPLACE, give 
MME 500017: ENABLE A Desired setting fo 

dees not possess the Log enable bit may not issue this 
e the description of the ENABLE command for a list of t 
ermissions by issuing an ENABLE command. Run List ( 
f the entire system (see ENABLE MME). This feature is t 


age and dates (Load-Dump enabled jobs only) or zero 


on is highly. privileged (enabled) it may use a command 
e command is Load-Dump enabled, § (a) Append rermi 
ME if they are Load-Dump enabled, and so most jobs may 
5.6.3 PASS at a Slave End Supoose now that upon ex 
UEST STATUS from a Slave End Upon receipt of the "pas 
(1) At the lowest slave end accepting special interrup 
cation file has a master end and one or more slave ends 
ster end. 5.1.1 Slave End COPY Commands A COPY co 
tions. 5.1.2 Master End COPY Commands As noted a 
idle. 5.6.7 Master End DRIVE Job A now issues a 
va- tion. When a slave end has reserved the file, it 
drive (see DRIVE-slave end in Section 5.2). The lo 
the corresponding slave end is trapred only if a non. 
_ [slave end issued READ special] 
terrupt number 11 (slave end issued READ) at the master 
terrupt number (Slave end issued READ) or 12 (slave 
ial] | [slave end issued REQUEST STATUS spec 
1) ai (slave end issued RESET STATUS scecia | 


_ errupt number two (slave end issued RESET STATUS) at th 
] 


. {slave end issued SET POINTER special 
terrupt number 15 (slave end issued SET POINTER) at the 
[slave end issued TRUNCATE special] 
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167 [slave end issued TRUNCATE special] 
144 26 terrupt number 14 (slave end issued TRUNCATE) at the ma 
167 30 terrupt number 14 (slave end issued TRUNCATE) at the ma 
69 [slave end issued WRITE special] 
171 [slave end issued WRITE special] 

69 19 ssued READ) or 12 (slave end issued WRITE) at the maste 
17L 42 terrupt number 12 (slave end issued WRITE) at the maste 
69 25 s reserved it, the slave end issuing the COPY command w 
22 12 #=- notifies the master end job that a read-type comma 
22. 29 - notifies the master end job that a TRUNCATE or SCR 
144 35 be issued on the master end of a communi- cation file. 
19. 30 VE command at the master end of a communication file ar 
64 34 ppeared. If the master end of a communication file is 
69 17 A COPY issued at a slave end of a communication file wi 
74 43 rive types at the master end of a communication file ar 
116 39 READ issued at the slave end of a communication file wi. 
137 32 a job file or the slave end of a communication file, t 
138 23 ence number of the slave end of a communication file, ¢ 
144 25 mand issued at the slave end of a communication file wi 
144 32 If the job at the master erd of a communication file is 
146 26 mand issued at the slave end of a cammimication file wi 
167 29 mand issued at the slave end of a communication file wi 
171 41 RITE issued at the slave end of a communication file wi 
75 44 y be issued on the slave end of a terminal ccmmunicatio 
74 38 pectively, at the master end of the communication file. 
138 28 s the duty of the master end of the communication file 
146 28 T POINTER) at the master end of the file. The second i 
22 33 . (See TRUNCATE-slave end only, Section 5.2.) 17 
87 12 be created and its slave end passed. (4) If the ret 
194 39 ervation. 5.6.6 Slave End Reservation; Local Operati 

184 [slave end reserve] 

184 [master end reserve] 

185 21 : (1) If the master end resets status on the comm 
187 15 lave end. 5.5.1 Slave End States First, the file a 
189 21 eagain. 5.5.2 Master End States The situation is 
64 35 is closed, or if a slave ernd to which the communication 
172 21 the corresponding slave end will be trapped only if 

141 37 h the master ard a slave erd will cause status to be re 
179 ll REQUEST STATUS (Master End) A REQUEST STATUS can be 
179 35 2 REQUEST STATUS (Slave End) A REQUEST STATUS to the 
181 27 »b. 5.2.4 DRIVE (Slave End) Certain drive types may 

181 [truncate (slave end) ] | 

181 {scratch (slave end) ] 

181 [set pointer (slave end) ] 
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lll 52 #£«file and pass its slave 
20 56 ive. (See DRIVE-master 
116 41 sued READ) at the master 
171 43 ued WRITE) at the master 
69 19 ued WRITE) at the master 
167 31 TRUNCATE) at the master 
21 54 DE). (See DRIVE-slave 
OF: 2): ds Job files, master 
42 20 nly. Job files, master 
112 24 h the exception of slave 
175 24 nd and one or more slave 
117 [master 
246 39 ENTRIES The number of 
121 29° sed) Lower: number of 
126 20 sed) Lower: number of 
59 11 500111: CHANGE CATALCG 
243 50 #£=this table contains the 
120 36 er is used to specify an 
125 30 er is used to specify an 
15 36 ult cell) is the initial 
81 ll MME 500112: 
94 ll MME 500102: OLD 
152-. Lh MME 500137: TALLY 
230 40 rmats: (1) For TALLY 
81 45 cesses except Write. An 
94 25 mand is exactly like the 
178 44 structure, such as OPEN, 
131 39 the sequence of commands 
229 22 atalog operations (OPEN, 
250 51 Many operations such as 
199 51 s a parameter for a RIN, 
148 42 be trapped with a format 
152 43 be trapred with a format 
156 51 be trapped with a format 
162 48 be trapped with a format 
225: 19.. 1.3/0; 6.6 Executive 
235 41 £cperation is 12 (format 
232 {format 
156 22 £file, trap bit mask and 
148 40 t 4 (020000 [cctal], the 
152 41 bit 4 (020000 octal, the 
156 49 bit 4 (020000 octal, the 
162 46 bit 4 (020000 cctal, the 
230 42 REPLACE: Bit 4 is the 
Pub. 1059 


word 


end, depending on whether bit 


end, Section 5.2.) 4 PF Pa 
end. The second interrupt wor 
end. The second interrupt wor 
end. The second word of the i 
end. The second word of the s 
end.) 13 R Slave issued: 


ends of communication files, a 
ends of communication files, a 
ends of communication files, f 
ends. Each end appears simila 
end] 

entries (descriptors and holes 
entries, including holes, in 
entries, including holes, in 
ENTRY xO. File reference num 
entry number of each file in i 
entry number. Upon completion 
entry number. Upon completion 
entry point to the job. When 
ERASE XO File reference num 
ERASE XO. File reference num 
ERASE XO File reference num 
ERASE and TALLY REPLACE: Bi 
ERASE command may therefore be 
ERASE command, except an X4 of 
ERASE, CATALOG, or REPLACE. [ 
CATALCG; however, the R 
REPLACE) provide two im 
REPLACE, SCRATCH are no 
UNCATALCG, TRUNCATE, SC 
if the treename contains 
if the treename contains 
if the treename contains 
if the treename contains 
Error Recovery If Executive 
error), then status word 2 wil 
error] 

escape special. convention bi 


escape convention bit) is set 
escape convention bit) is set 
escape convention bit) is set 
escape convention bit) is set 
escape convention bit (see bel 
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231 33 words’ are Zero. 

152 22 8) must be zero, (bit 4) 
162 22 8) must be zero, (bit 4) 
84 ll MME 500117: 
29 35 opened. (3) On RON, 
64 46 e the description of the 
106 50 he supra, job on a RUN or 
36 17 bles a job to receive an 
15 23 fr counts to zero, and an 
15 48 1.3.5 Parity Faults; 
15 27 ardware timer runout nor 
143 14 E is very similar to the 
1315 of the code for a valid 
12 17 em. 1.2.3 MME Faults; 
14 49 faults normally indicate 
225 19 by Physical I/O. 6.6 
36 17 ob to receive an execute 
24 18 curred, then the connect 
46 18 o receive a timer runout 
15 43 ection 1.4. The parity 
15 44 future use. The startup 
18 46 ord of the slave connect 
15 34. The shutdown and connect 
13 25 is divided into two-word 
43 18 e real-time timer runout 
11 54 for too long, a lockup 
15 23 to zero, and an execute 
15 22 s given. A timer runout 
13. 14 xr out of bounds, the MME 
24 19 #£4any, and then any slave 
14 37 Il1ts Whenever a memory, 
22 49 cial interrupt, or slave 
13:21. tivevcall. 1.3 Slave 
18 48 t takes place. No dirty 
14 26 ro, the job had a "dirty 
15 25 o be aborted for a dirty 
15 35 pecial uses in the slave 
42 36 released, then a memory 
36 18 #£(real-time timer runout 
24 29 cial interrupt, or slave 
14 15 faults. To give a slave 
25 53 MME instruction unless a 
47 33 e specified IC/IR. Ifa 
25 39 and will result in a MME 
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The "Escape Convention” bit (020000 


escape special convention, ( 
escape special. convention, ( 
EXECUTE X00 File reference n 
and CONTINUE, gives te 
command for a descript 
command). A job can a 
fault (real-time timer 
fault is given if the 

Faults When a job ge 
execute faults are returned as 
EXECUTE MME (500117) and diffe 
Executive call are always 101 

Executive Calls A slave job 

Executive calls. However, if 

Executive Error Recovery I£ 

fault (real-time timer runcut 

fault (special interrupt) if a 
fault after a specified amount 
fault cell is not currently us 
fault cell is not used by the 

fault cell) is zero, a slave 
fault cells have special uses 

fault cells, one for each of t 
fault has occurred. If anNg 
fault is generated. This faul 
fault is given if the real-tim 
fault is returned if the run-t 
fault is returned to the slave 
fault other than simulated sla 
fault tag, DRL, lockup, illega 
fault to be given to a job eac 
Fault Vector The first 40 (o 
fault vector aborts are gene 
fault vector” and is aborted; 

fault vector. The simulated f 
fault vector. Word 0 (the fir 
fault will cccur. The amount 
fault) after a specified amoun 
fault, it is unsqueezed. The 

fault, the Executive stores th 
fault, trap, or special interr 
fault, trap, or special interr 
fault. (A job receives a MME 


execute 
execute 
Execute 
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MME (master mede entry) 
Parity Faults; Execute 
the following means: 
serious error. Command 
timer runcut nor execute 
ted in slave mcde. MME 
Executive since all MVE 
ect faults, timer runout 
category are all connect 
cde: I/O interrupts and 
her than simulated slave 
thers are used for slave 
and startup and shutdown 


use it. 1.3.5 Parity 
catalog to open. If the 
or the presence of the 


or 
-l)st 


the presence of the 
catalog, and the 
Creating a Ccmminication 
1, then a communication 
in the COPY is a device 
On 5525) 4 PF Passed 
ssed. 5 RF Returned 
RCF Read ccomminication 
copies between a device 
r create a communication 
r end of a communication 
rns on the communication 
[cammnication 
{communication 
ime. The "communication 
ear busy ("communication 
busy ("communi- cations 
LOSE.) A terminated job 
end of a canmunications 
was passed. 6 FCLO 
S$ Closely followed by a 
ial interrupt of type 6 
is zero, then the Master 
a tree, with the Master 
is zero, then the Master 
subcataleg of the master 
{[MFD = Master 


{read comm file 


page line 
12 21 
15 48 
9 43 
14 45 
15 27 
14 49 
47 38 
LY .35 
ll 35 
li 18 
24 19 
13 29 
ll 36 
15 48. 
100 38 
101 47 
157 47 
102 35 
191 26 
87 11 
176 21 
24. dh 
21 21 
20 41 
177 33 
ELL. “52 
19 30 
182 50 
87 
mas 
186 32. 
187 26 
188 18 
88 50 
18 26 
21 28 
197 20 
64 36 
157 15 
237: 29 
101 20 
199 40 
233 
74 
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word 


fault. 
Faults 
faults 


The address field of t 
When a job generates 

indicating that the jo 
faults are generated when a pr 
faults are returned as slave f 
faults normally indicate Execu 
faults will be returned to the 
faults, and startup and shutdo 
faults, timer runout faults, a 
faults. I/O interrupts cannot 
faults. The job will thus pro 
faults. The position of the i 
faults. These events are not 

Faults; Execute Faults When 


fetch bit (bit 4) of x4 isl, 
fetch bit (bit 4). I the fet 
fetch bit (bit 4). I£ the fet 


fetch bit is on in the access 
File Suppose that job A has 
file will be created and its 
file (see Chapter 6), then t 


File - notifies the job that a 
file ~- notifies the jcb that a 
File - used to notify a slav 


file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
File 
"File 
(file 
File 
File 
File 
file 
File 


and communication file sh 
and pass its slave end, d 
are bounced. The methcd 
bit (bit 1) in the access 
bit] 

bit] . 

busy” status (6) is a spe 
busy”) to all other slave 
busy") to this end. Only 
can always be recognized 
can be "bounced" toa h 
Closed - notifies the job 
closed" special as its fi 
closed) is generated at a 
Directory (MFD) is search 
Directory (MFD) as the ro 
Directory is searched. A 
directory. A slave jobo 
Directory] 

drive] 
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141 36. ssued on a communication file 
144 28 ). If the communication file 
64 34 r end of a communication file 
64 45 US. If a suspended job file 
84 40 or, which is on. A job file 
74 36 are O (set communication file 
200 24 the other must be a core file 
74 27 only on a communication file 
200 32 file via a communication file 
192 42 jobC receives a passed file 
48 {returned file 
64 {returned file 
74 {read comm file 
184 14 are changed to a special file 
199 — [file 
69 17 e end of a communication file 
116 639 e erd of a communication file 
146 27 e@ end of a communication file 
167 30 e erd of a communication file 
171 41 e end of a communication file 
184 15 #£file type called a "nen-file” 
195 43 es a "read communication file” 
180 27 (1) “Read cammunication file” 
182 56 a slave end in a “passed file” 
183 49 notified by a "returned. file” 
191 Sl se itis 7) in a “passed file” 
192 14 n receipt of the “passed file" 
197 19 bD receives a "returned file” 
246 33 escriptors. TYPE The file’ 
lil. 31 terrupt number 4 (passed file) 
48 21 terrupt type 5 (returned file) 
64 27 rrupt number 5 (returned file) 
199 25 ype 6 (special cataloged file) 
64 52 rrupt number 5 (returned file) 
117 13 s a master communication file, 
69 44 dof a communica- tion file, 
66 49 tus are reset on the job file, 
117. 20 munication or a shared file, 
70 44 rce) file must be a core file, 
20 24 OSE on a communication file, 
138 24 e end of a communication file, 
172 50 ination file is a device file, 
136 54 pended or terminated job file, 
137 32 e end of a communication file, 
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for which an operation is 


is busy, either because a 
is closed, or if a slave 
is closed, then that job 
is created for the new jo 
mode) and 12 (single devi 
or a job file. In genera 
or on a device file. Dri 
should be swapped out of 


type called a "non-file" 


will generate a special i 
will generate a special i 
will generate a special i 
will generate a special i 
will generate a special i 
(13), and the jobs holdi. 
drive, the special inter 
drive: A drive of type 
special interrupt (see t 
special interrupt (if it 
special interrupt. The f 
special interrupt, suprfo 
special interrupt due to 
Ss type. Described below 
iff that job is accepting 
is generated for each re 
«* JE LEIS ascratch £21 
. They are associated wi 
. The job issuing the CLO 
the corresponding slav 
and Xl is nonzero. The 
or when the job terminat. 
that file is reserved fo 
the issuing job's core, 
the lower half of the DA 
then a special interrupt 
then the lower half of s 
then the status informat 
then the status informat 
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180 47 a terminal comminication file, to indicate the receip 
184 16 on-files are notified by file-closed special interrupts 
112 12 sed with a communication file. If XO is zero, then th 

74 28 tion file or on a device file. Drives on communication 
200 24 be acore file or a job file. In general a slave job 
172 20 £ a master communication file. In that case, the cor 
172 27 ication file or shared file. In that case, the commu 

75 44 a terminal comminication file. The drive type (contain 
143° 20 the newly created job file. This remains open with 

88 25 when creating scratch file/catalogs (see OPEN SCRATC 

94 27 hich means that only one filename can be specified — a 

97 29 hich means that only one filename can be specified — a 
100 31 le (denoted by a list of filenames which form a "treena 

59 [filename] 

121 [filename] 
126 [filename] 
231 [filename] 

96 11 LD READ CATALCG AND OPEN FILES x0 File reference num 
124 ill READ CATALOG AND OPEN FILES x0 File. reference num 
124 | {migrated files = offline files] 

124 33 he READ CATALOG AND. OPEN FILES command combines the fun 
96 32 he READ CATALOG AND OPEN FILES command with two excepti 
114 37 a READ CATALOG AND OPEN FILES ccommand. Status Return 
38.50 he READ CATALCG AND OPEN FILES command. When a job is 
181 40 r terminal communication files in particular, it is use 
70 42 £=files are communication files is not allowed. If the 
124 47 Information for migrated files is provided only if the 
- 77 41 = , see Chapter 6, "Device Files". Except as noted abov 
2 20 er ends of communication files, and file/catalegs which 
87 21 job is resumed. Job files, master ends of ccommunic 
1i2 20 cation files only. Job files, master ends of ccammunic 
251 16 ved as special cataloged files, since their DA's point 
76 #19 d drive types for device files: 12 (single device actio 
124 migrated files = offline files] | [ 
196 destroying communication files] [ 
197 destroying communication files] { 

44 [job file] , 

232 n] | [special first name = special conventio 
152 44 ename contains a special first name. For more informa 
156 52 ename contains a special first name. For more informat 
148 43 ename contains a special first name. The name and pass 
162 49 ename contains a special first name. The name and pass 
185 32 setting the appropriate flag bit in an index register. 
78 21 setting the appropriate flag bit in X4 (see COPY MME). 
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184 54 setting the appropriate 
68 24 mber of device file X4 
74 18 ve with DcW's only) X4 
116 .18 memory location M2 X4 
141 16 ber of file/catalog x4 
171 18 e (may not be zero) X4 
228 25 eserve bit is set in the 
69 53 he master end job. The 
75 26 ith a status of 7. The 
116 53 ith a status of 7. The 
141 49 ed for that end). The 
172 11 ha status of 7. The 
193 54 by setting BSNTPD in the 
193 37 by setting BSNTPS in the 
148 42 g will be trapped with a 
152 43 e will be trapped with a 
156 51 n will be trapped with a 
162 48 e will be trapped with a 
235 41 rom the operation is 12 
232 
224 24 t card.) Magnetic Tare 
18 53 the end of its. special 
222 37 errupt timeout status. 
120 39 ferred. Note that since 
125 32 ferred. Note that since 
243 34 unused) 
246 39 entries (descriptors and 
121 29 er of entries, including 
126 20 er of entries, including 
200 44 section, called Physical 
225 22 ery is enabled, Physical 
137 53 (q.v.). Lower: Unique 
190 U1 munication file are both 
193. 46 ommunication file is now 
188 49 (20). Both ends beccme 
188 15 th, the slave end may be 
190 55 though the master end-is 
191 52 terrupt. The file is now 
187 18 d may both be completely 
196 26 file busy” (6). 5.6.8 
14 37 #£°fault tag, DRL, lockup, 
14 38 illegal procedure (IPR), 
60 19 contain the new usage 
55 45 mation or is zero. Type 


Page 276 


word 


flag bit when issuing those co 
Flag bits xX6 Trap location 
Flag bits X6 Trap location 
Flag bits X6 Trap location 
Flag bits X6 Trap location 
Flag bits. X6 Trap location 
flag bits in X4 ('200000' for 
flag bits in X4 are divided in 
flag bits in X4 have the follo 
flag bits in x4 have the follo 
flag bits in x4 have the follo 
flag bits 
flag bits, the first five word 
flag bits. The first ten word 
format error if the treename c 
format error if the treename c 
format error if the treename c 
format error if the treename c 
(format error), then status wor 
{format error] 
Handler Note that 
handling routine. 1.4.5 Sa 
High-Speed Printer The user 
holes can occur in catalogs an 
holes can occur in catalogs, a 
"Holes" are created whenever ob 
holes) in the catalog. Jobs wh 
holes, in catalog 6 Zero 
holes, in catalog 6 Zero 
I/O (PIO) will attempt to tran 
I/O will attempt standard erro 
Identifier. This field can be 
idle (from the master's point 
idle again. Suppose job C sh 
idle, as does the communicatio 
idle, but the file may be rese 
idle, no operation except CLOS © 
idle. 5.6.2 REQUEST STATU 
idle. In this state, any valid 
Illegal Actions Suppose job 
illegal precedure (IPR), incom 
incomplete op (ONC), overflow/- 
information for the file. The 
information has the following | 


it is the 
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page line 
149 19 lower half contains type 
55 41 ts to two words of usage 
11 46 rrupts by the use of the 
13 12 address field of the MME 
47 33 nted to by X7, and a RET 
22 54 faults by issuing a FET. 
17. 13 e should end with an RET 
24 35 ezed mcde, since the RET 
25 36 MME (master mode entry). 
18 19 ortunity after a special 
180 19 ssues a DRIVE, a special 
lll. 31 X0,. generating a special 
47 34 fault, trap, or special 
19 35 on5.2. 1.4.7 Special 
19 19 However, once a special 
18 41 #£interrupt data (special 
17 56 pt data entries (special 
17 46 ter to the job's special 
18 42 re stored in the special 
17 35 upts only if its special 
177 18 #4zvalid, nonzero, special 
15 38 11) is the job's special 
196 16 mpts to give the special 
25 53 #£fault, trap, or special 
17 24 encountering any special 
24 18 e connect fault (special 
177 50 has received the special 
43 18 til N traps, one special 
22 48 e than one trap, special 
24 29 receives a trap, special 
191 51 a “passed file" special 
20 30 1.4.8 Types of Special 
17 29 issued. 1.4.2 Special 
ll 27 rs.. 1.2.2 Transparent 
19 ll. 1.4.5 Saved Srecial 
19 26 1.4.6 Bouncing Special 
9 49 ions have completed 
177 18 end be accepting special 
181 34 he corresponding special 
11 18 leaving slave mde: I/0 
15 40 interrupt cell. Srecial 
li 30 rupts Certain types of 
181 52 nd will generate special 
185 53 The routing of special 
Pub. 1059 


word 


information or is zero. The s 
information to be placed in th 
inhibit bit. This hardware fe 
instruction does not specify a 
instruction is executed throug 
instruction to the appropriate 
instruction whose address fiel 
instruction will not "resqueez 
instruction with an address fi 
interrupt is generated (caused 
interrupt is generated at a sl 
interrupt number 4 (passed fil 
interrupt occurs while the jeb 
Interrupt Pair Format The tw 
interrupt pair has been saved, 
interrupt pair) are stored i 
interrupt pairs) which will f1 
interrupt stack. The tally wo 
interrupt stack. The address 

interrupt tally word (word one 
interrupt tally word — see Se 
interrupt tally word. The conn 
interrupt to the lowest slave 

interrupt was generated. as the 
interrupt which occurred at th 


interrupt) 
interrupt, 
interrupt, 
interrupt, 
interrupt, 


if any, and then an 
it must eventually 
or one real-time ti 
or slave fault to b 
or slave fault, it 


interrupt. The file is now idl 
Interrupts Type Mnemonic 

Interrupts A special interru 
Interrupts Certain types of 

Interrupts If the job's spec 
Interrupts Cnly special inte 
interrupts usually indicating 
interrupts (have a valid, nonz 
interrupts (set mede and slave 
interrupts and faults. I/O in 
interrupts are described in de 
interrupts are normally transp 


interrupts 
interrupts 


at the master erd j 
is also affected by 


Page 277 


SYSTEM PROGRAMMING REFERENCE MANUAL 


Page 278 


page line word 
16 15 using traps and special interrupts. 1.4.1 Traps A. 
18 {bounced special interrupt] 
18 [saved special interrupt] 
14 38 ckup, illegal procedure (IPR), incomplete op (CNC), ove 

21 50 ure use. 12 D Slave issued drive — notifies the ma 

181 _ [slave-issued drive special] : 

181 35 upts (set mede and slave-issued drive) at the job holdi 
22 ill. e end.) 13 R Slave issued read - notifies the mas | 
69 [slave end issued READ special] 

177 {slave issued READ special] 

177 25 errupt indicating "slave issued READ" (a job requested 

193 52 Job A receives a "slave-issued read" special interrupt 

194 21 s notified with a "slave-issued read" special interrupt 

16 40 upt number 11 (slave end issued READ) at the master end 

192 18 special interrupt (slave-issued read) is generated at j 
69 18 upt number 11 (slave end issued READ) or 12 (slave end 
22. 22) 1 Sede) 15 RS Slave issued request status - notifi 

138 [slave end issued REQUEST STATUS special] 

138 25 wupt number 13 (slave end issued REQUEST STATUS) is gene 

179 40 job issues it, a "Slave issued request status” special 
20 48 n 5.2.) 2 SRS Slave issued reset - notifies the ma 

190 53 job has received a slave-issued reset special interrupt 

188 {slave issued reset special] 

141 {slave end issued RESET STATUS special] 

141 41 pt number two (slave end issued RESET STATUS) at the ma 

188 53 pecial interrupt ("slave issued reset”) that its COPY i 
22.. 35:2 1 5<2<) 17. SP Slave issued set pointer - notifies 

146 - [slave end issued SET POINTER special] 

181 55 #£=a SET POINTER, a "slave-issued set pointer" special is 

146 28 upt number 15 (slave end issued SET POINTER) at the mas 

144 [slave end issued TRUNCATE special] 

167. {slave end issued TRUNCATE special] 

181 54 #£the slave end, a "“slave-issued truncate" special is ge 

182 11 e end generates a "Slave-issued truncate" special speci 

144 26 wupt number 14 (slave end issued TRUNCATE) at the master 

167 31 upt number 14 (slave end issued TRUNCATE) at the master 
22 17 on 5.1.) | 14 W Slave issued write - notifies the ma 
69 {slave end issued WRITE special] 

171 [slave end issued WRITS special] 

177 28 #£=°£in response to a "Slave issued WRITE" special, it shou 

193 33 twenty words. A "slave-issued write” special interrup 
69 19 d READ) or 12 (slave end issued WRITE) at the master en 

171 42 upt number 12 (slave end issued WRITE) at the master en 
84 30 ¢t (in 1/64 milliCRU) Q Job acess mask The source f 
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87 38 dwhen.it is passed. Job Access Mask (Q register) 
106 49 ted by bits 29-35 in its job access mask (set by the su 
88 11 ng job is ANDed with the job access mask specified in t 
44 [job core] 
68 [job core] 
88 50 ee CLOSE.) A terminated job file can always be recogni 
64 45 STATUS. If a suspended job file is closed, then that 
84 40 icator, which is on. A job file is created for the ne 
66 49 status are reset on the job file, or when the job term 
136 54 suspended or terminated job file, then the status info 
200 24 must be a core file or a jcb file. In general a slave 
143. 20 d to the newly created job file. This remains open w 
87 21 the job is resumed. Job files, master ends of ccmm 
112 20 munication files only. Jcb files, master ends of ccmm 
44 [job file] | 
253 11 eady cataloged). 9.5.2 Jeb quotas To prevent jobs f 
14 28 fault vector. The supra job then has the option of con 
40 lL MME 500012: JCB TIME No arguments The 
84 18 pend to source file X3 Job type (bits 0-8) X4 Maxim 
85 11 of X3 are ANDed with the job type bits allowed to the j 
38 19 r reset (bits 0-8) The job type of a running joo cons 
70 44 a core file, the issuing job's core, or a communica- ti 
- 9 33 Executive to suspend the job. Executive entries that a 
14 29 nating the aborted slave job. This feature is intended 
38 30 sidence permission . 2 Large State Vector permission 
85 15 which it is enabled are Large State Vector, Priority S 
86 22 The remainder of the run list contains a list of file/c 
84 35 ith the files in the run list open for it. The new job 
85 42 ————————+ The run list pointed to by XS must be 
127 35 b issuing the command is Load-Dump~= = enabled, (a) 
126 28 #=is not enabled with the Load-Dump permission) The 
148 29 nter to usage and dates (Load-Dump enabled jobs only) o 
60 17 red. (4) Ifa jeb is Load-Dump enabled, and if x5 i 
247 23 sue this MMB if they are Load-Dimp enabled, and so most 
56 20 bute. If the job is not Load-Dump enabled, or if X5 is 
38 37 reating a catalog) 4 Load-Dump permission (allows p 
107 15 ya job enabled with the Load-Dump permission will caus 
149 15 the jcb is enabled with Load-Dump permission and x7 is 
55 39 ALOCG MME is enabled with Load-Dump permission, and if X 
114 24 # by jobs enabled for the Load-Dump permission. Nonenabl 
189 49 he master end. The only local cperation which can te i 
187 32 ET STATUS functions as a local operation, with the addi 
195 33 is legal, since it is a lecal cperation. Any nonlocal 
194 39 Slave End Reservation; Lecal Operations Now conside 
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line 


‘Or DRIVE cammands. 


ony, 


LO; 


S$ passed. 


word 


omminication file. Only local operations (see Section 
other slave ends. Only local operations can be issued 
of its ends being busy. Local operations may be issued 
d. No operations except local operations or CLOSE can 
p each other. A job may lock the file specifying that 
o an idle, unreserved (unlocked) state at the issuing e 
{locked] 
[locked] 
[locked] 
d code for tco long, a lockup fault is generated. Th 
memory, fault tag, DRL, lockup, illegal procedure (IPR 
| MME 500142: LOG XO Reserved for future 
Db to abort system) 7 Leg (allows jcb to do MME LCG) 
ich does not possess the Log enable bit may not issue t 
y Scheduling, Crash, and Log. The spawned job must ena 
| ' MME 500013: LONG PAUSE xX5 Number of tra 
nd for the last card.) Magnetic Tape Handler Note t 
estion is powered off. MAJOR STATUS (Bits 2-5) - This 
The Major Status, which is four bi 
t (normally on). 1-5 Major status. 30-35 Record 
mMil1iCRU) Q Job acess mask The source file, which 
(bits 9-17) trap bit mask X5 Pointer to two words 
on, (bits 9-17) trap bit mask X5 Pointer to two words 
o 6 (bits 9-17) trap bit mask X5 Reserved for future 
(bits 9-17) trap bit mask X5 Reserved for future 
PEN (bits 0-8); Trap bit mask (bits 9-17) X5 Points t 
Job Access Mask (Q register) 
its job access mask (set by the supra job on 
es on the file, trap bit mask and escape special conv 
E 500136). The trap bit mask 
limited by the trap bit mask in bits 9-17 of X4. Int 
ts 9-17 are the trap bit mask to be used during the oO 
sued read - notifies the master end job that a read-t 
outstanding at both the master and a slave end will ca > 
comminication file has a master end and one or more sla 
@ Operations. 5.1.2 Master 
ecomes idle. 5.6.7 Master 
runcate - notifies the master 
y a DRIVE command at the master 
ch disappeared. If the master 
Valid drive types at the master 
of 6. If the job at the master 
cannot be issued on the master 
12, respectively, at the master 


29~35 in 


DRIVE | 
job that a TRUNCATE . 
of a cammunication 
of a communication 
of a communication 
of a cammunication 
of a communi- catio 
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line 


word 


d, it is the duty of the master 
sued SET POINTER) at the master 


(master 
however: (1) I£ the master 
is idle again. 5.5.2 Master 


5.2.1 REQUEST STATUS (Master 
reak drive. (See DRIVE-master 
end issued WRITE) at the master 

end issued READ) at the master 
issued TRUNCATE) at the master 


end issued WRITE) at the master 
‘ resumed. Job files,. master 
files only. Job files, master 


[master 


if XO is zero, then the Master 

if XO is zero, then the Master 

direct subcatalog of the master 

[(MFD = Master 

rawn as a tree, with the Master 
rated when a privileged (master 
If the file/catalog is master 
or those returned by the master 
~28 Permission bits for master 
Oo note that whenever the master 
| [master 

[master 

[master 

{master 

[master 

ed by a successfully run master 
Word Function 0 
Word Function 0 

7 LEN or 


500124: CHANGE CATALOG 
is specifying a negative 
exceeded even though the 

1 Length of file or MAX 
7 Length of file or 
7 Length of file or 
he length of the file or MAX 
he length of the file or MAX 
tains the current length/MAX 
asked off if the catalog MAX 


of 
of 
‘o) 
of 
of 
or 
of 


end of the communicatio 
end of the file. The s 
end reserve] 

end resets status on th 
End States The situat 
End) A REQUEST STATUS 
end, Section 5.2.) 4 

end. The second word o 
end. The second interr 
end. The second word o 
end. The second interr 
ends of communication f 
ends of cammunication f£ 
end] 
File 
File 
file 


Directory is searc 
Directory (MFD) is 
directory. A slav 
File Directory] 

File Directory (MFD) as 
mede) instruction is ex 
or slave trapped, then 
trap program if thec 
trap program (see CAT 
trap program is run dur 
trap program] 

trap program] 

trap program] 

trap program] 

trap program] 

trap, then all reques 
1 ALCC (amount of stor 
1 ALCC (amount of stor 


The maximum length which 
XO File reference numbe 
for a 
may still be exceeded afte 


scratch catalog; o 


catalog 2 Read/writ 
catalog 8 Upper: s 
catalog See Chapter 9 f 


the catalcg in the seco 
the catalog. Status 
the file/ catalog. Not 
the next-to-last entry 
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103 27 £ the opened file or the MAX of the opened catalog in s. 

158 32 £ the opened file or the MAX of the opened catalog in s 

163. 15 h of the scratch file or MAX of the scratch catalog is 

106 20 rap location A Catalog MAX or preallocation length N 
62 32 rrent ALOC. ALCC's ard MAX's are described in Chapter 

251 49 £ the month LENGTH (or MAX) If the descriptor is fo 

103 17 ds twice its permissible MAX. Finally, bit 0 of the ac 

127 44 twice its. permissible MAX; (6) Any remaining bi 
42 36 mory is released, then a memory fault will occur. The 
42 ll MME 500006: MEMORY REQUEST X5 Upper mem 
10 32 ily when the job issues a MEMORY REQUEST call (on a MME 
21 45 ock is released with a MEMORY REQUEST ccmmand before 
84 52 spawned job can issue a MEMORY REQUEST to change the s 
14 37 lave Faults Whenever a memory, fault tag, DRL, lockup 

138 14 cataloged files. 4-N Message specified by PASS ccmm 

lil 40 a nonzero word, then the message specified can be read © 
87 32 by the PASS command, no messages accompany files passe 

233 [MFD = Master File Directory] — 

242 34 wo special catalogs, the MFD and SMCORCAT, are allocate 

233 12 cog is to be found in the MFD catalog specified by x3. 

252th sogse-: At present, the MPD is the only specially-cata 

124 ] [migrated files = offline files 

124 47 g read. Information for migrated files is provided onl 

210 20 is given in cctal. The Minor Status (Substatus) is si 
76 #5O r transferred). 6-11 Minor status. 12-17 Queue 

202 [substatus = minor status] 

202 {minor status] 

143 14 y similar to the EXECUTE MME (500117) and differs only 
12 21 xecutive by generating a MME (master mode entry) fault. 
25 36 e command by executing a MME (master mode entry) instru 

149 21 #gin the lewer half. See MME CATALOG or Chapter 9 for m 
13 13 e, or out of bounds, the MME fault is returned to the s 
25 39 ccammand will result in a MME fault. (A job receives a 
14 49 xecuted in slave mode. MME faults normally indicate E 
47 38 the Executive since all MME faults will be returned to 
13 11 the address field of the MME instruction does not speci 
25 45 d immediately by a PAUSE MME with a pause count of one. 
25 46 d 200 series, or pausing MME's. The contents of the sl 

181 42 output medes (see DRIVE MME). The exact interpretatio 
14 42 ntire system (see ENABLE MME). This feature is to allow 
60 21 to by X5 of the CATALOG MME. Upon completion of the | 
62 23 ses via the ALTER ACCESS MME. The previous MAX for the 
10 16 1.1 Running in Slave Mcde. A job actually running 
14 50 g the MME is in squeezed mode (entered by the Executive 
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24 28 #$job running in squeezed mode (see SQUEEZE, MME 500007 
20 35 onic Use O SIM Set mode - used to notify the mast 
9 23 of a processor in slave mode and may perform any legal 

181 34 special interrupts (set mede and slave-issued drive) a 

181 32 ob. In particular, a set mede drive (type 0) or a devic 
74 [set mode drive = set mede special] 
74 {set mode drive] 

181 [set mede drive] | 

228 33 nga file open in shared mede may specify only the job’ 
740 {set mode drive = set mede special] 

181 {set mede special] 

142 26 =a file cpened in shared mede will cause the file to re 
74 36 (set camminication file mede) and 12 (single device ac 
14 45 hen a privileged (master mode) instruction is executed | 
70 26 le is opened in shared mode, do not allow any copy—-ty 
13 ll I£a jeb is in squeezed mde, or if the address field 
14 46 ion is executed in slave mde. MME faults normally in 

158 21 open the file in shared mde. If the file is not alre 

227 {shared mode] 

126 49 wer: ccded date of last modification 7 Length of f 

121 [DLM = date of last modification] 

56 20 set the file's Date Last Modified attribute. If the jo 

125 22 #£1last used and date last medified in the catalog entry 
96 41 and the coded date last modified in the lower. | 

149 21 half and coded Date Last Modified in the lower half. S$ 
96 34 ntains a ceded date last medified. Informa- tion for = 
38 26 Bit Function 0. Monitor permission (affects sc 

225 11 his responsibility. MPC The Reset operation on a 

205 21 MP) Reset MPC. Puts the MPC into an idle state. This 

201 46 d Peripheral Controller (MPC). The general meanings of 

233 21 atalog in the catalog "MUD" in the catalog specified 

232 [special first name = special convention] 

152 44 contains a special first name. For more information o 

156 52 contains a special first name. For more information on 

148 43 ccntains a special first name. The name and password o 

162 49 contains a special first name. The name and password o 

193 29 5.6.4 COPY Command with No-Trap Opticon Job D new iss 

194 12 ted" (2). Note that the no-trap option had no effect, 

193 40 ob (job A) specified the no-trap option. Supoose job 

178 lil is issued. 5.1.3 The “No-Trap" Cotion When the mas 

176 #47 «4+ end job exercises the "no-trap" option — see below). 
178 36 see Section 5.6. 5.2. Non-—COPY Commands Ccmmunicat 
184 #15 cial file type called a "non-file" (13), and the jobs h 
12 28 alis are of three types: nontrapping, trapping, and tra 
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), and is a legal user number format the scanner will 
table contains the entry number of each file in its cat 
used to specify an entry number. Upon completion of th 
used to specify an entry number. Upon completion of th 
| [octal] 

cifying a file type of off-line but the file has devi 
ble file type, which is "off-line" (14 octal). Files t 
[off-line] | 

{migrated files = offline files] 


on. MME 500102:. OLD ERASE x0 File reference 


MME 500125: OLD READ CATALOG AND OPEN FILE 
MME 500130: OLD REPLACE x0 File referen 
re (IPR), incomplete op (ONC), overflow/truncate, or di 
_ MME 500101: OPEN x0 File reference numb 
MME 500136: TALLY OPEN XO File reference numb 
permissions using TALLY OPEN (MME 500136). If the ope 
file is made using TALLY OPEN (MME 500136). The trap b 
5: OLD READ CATALCG AND OPEN FILES x0 File referenc 
00127: READ CATALOG AND OPEN FILES x0 File referenc 
Ss The READ CATALCG AND OPEN FILES command combines th 
ike the READ CATALOG AND OPEN FILES command with two ex 
in the READ CATALOG AND OPEN FILES command. When a j 
Suing a READ CATALOG AND OPEN FILES command. Status RR 
in the catalog tree (see OPEN MME). This file referenc 
MME 500100: OPEN SCRATCH x4 File/catalo 
tch file/catalogs (see OPEN SCRATCH) The jod file f 
the command. (2) On OPEN, ALTER ACCESSES, DUPLICAT 
talog structure, such as OPEN, ERASE, CATALOG, or REPLA 
ing" catalog operations (OPEN, ERASE, REPLACE) provide 
the sequence of commands OPEN, UNCATALOG, and CLCSE. 
quence of commands TALLY OPEN, UNCATALOG, and CLOSE. 
n shared mode, see TALLY OPEN. A file which is to be 
file/catalog using TALLY OPEN. If Read, Write, and App 
ation. (2) For TALLY OPEN: Bits 0-3, 5-8 are the 
ime the file/catalog was cpened, and if they do not con 
_ [TALLY OPEN] | 
ter end. The only local cperation which can be issued 
TUS functions as a local operation, with the additional 
gal, since it is a local operation. Any nenlocal cperat 
e End Reservation; Local Operations Now consider what 
cation file. Only local operations (see Section 5.5) ¢ 
Slave ends. Only local cperations can be issued at th 
ends being busy. Local operations may be issued even 
operations except local cperations or CLOSE can be iss 
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193 29 OPY Command with No-Trap Cption Job D now issues a CO 
178 11 5.1.3 The "No-Trap" Option When the master end j 
176 47 ° exercises the "no-trap"” option — see below). This m 
194 12 . Note that the no-trap option had no effect, since th 
193 40 A) specified the no-trap option. Suppose job A new is 
14 38 R), incomplete op (ONC), overflow/truncate, or divide c 
LOD: 1d. MME 500106: OVERLAY x0 File reference n 
19 35 1.4.7 Special Interrupt Pair Format The two data wor 
19 19 once a special interrupt pair has been saved, the speci 
18 41 #£=data (special interrupt pair) are stored in the spec 
17 56 tries (special interrupt pairs) which will fit in the s 
15 43 il in Section 1.4. The parity fault cell is not curre 
15 48 shes to use it. 1.3.5 Parity Faults; Execute Faults 
21 12 een passed to it via the PASS ccmmand. This special 
lili ill , MME 500122: PASS x0 File reference numb 
182. 22 cial interrupt. 5.2.6 PASS and CLOSE These ccmmard 
192 32 were available. 5.6.3 PASS at a Slave End Suprose 
138 14 -N Message specified by PASS command The message sta 
182 46 created by a create-type PASS command (or by the implic. 
791. 45° ~“< Jcb A now issues a PASS ccammand to job B, specify 
87 32 d to files passed by the PASS command, no messages acco 
182. 55 d. The job to which the PASS is issued receives the fi 
195 33 west) Job D's implicit PASS is legal, since itisal 
183° 36 set, it may not CLOSE or PASS it again until the newly 
192 37 . It therefore issues a PASS to job C, specifying file 
187. 39 ations are RESET STATUS, PASS, and, if the end was pass 
21 16 ile special is due to a “passback" from an immediate 
197 45 b's immediate supra job (PASSBACK). There is no operat 
112 7 [passback] 
2L il , Section 5.2.) 4 PF Passed File - notifies the job 
192. 42 id, and job C receives a passed file special interrupt 
182 56 ber of a slave erd in a "passed file" special interrupt 
191 51 (suppose it is 7) in a “passed file" special interrupt 
192° 14 d Upon receipt of the "passed file" special interrupt 
lil 31 cial interrupt number 4 (passed file) if that job is ac 
86 [pass] 
41 ll MME 500013:. LONG PAUSE XS Number of traps 
43 11 MME 500005: PAUSE X5 Number of traps 
18 30 e the description of the PAUSE call in Chapter 3). (3) 
12 47 calls with the autcmatic pause feature share features o 
25 45 ollowed immediately by a PAUSE MME with a pause count o 
41 17 s identical in effect to PAUSE. LONG PAUSE should be u 
12 #29 #£trapping with autamatic pause. The action requested b 
25 46 re called 200 series, or pausing MME's. The contents o 
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12 54 even after the automatic pausing type of Executive call 
199 39 # files are cataloged in :PERCAT, a direct subcatalog of 
199 22 e job wishes to access a peripheral it makes use of a d 
38. 28 ly) 1 Core Residence permission 2 Large State V 
38 26 Function Q Monitor permission (affects scheduling 
38 33 s) 3 Special Catalog permission (allows a job to 
38 37 catalog) 4. Load-Dump permission (allows preallocati 
38 30 2 Large State Vector permission (permits a state 
108 43 th the Special Catalog permission and is specifying m 
149 15 s enabled with Load-Dump permission and X7 is non-zero, 
180 55 ch has eXecute ("break") permission on its end of the 
107 15 abled with the Load-Dump rermission will cause N words 
126 29 led with the Load-Dump permission) The format of th 
114 24 nabled for the Load-Dump permission. Nonenabled jobs wh 
183 18 nelude "break" (eXecute) permission; if they do not, ho 
74 {break permission] : 
191 [break permission] | 
200 44 d. This section, called Physical I/O (PIO) will attemp 
225 22 ror recovery is enabled, Physical I/O will attempt stan 
146 ll | MME 500113: SET POINTER x0 File reference n 
181 48 UNCATE, SCRATCH, and SET POINTER (Slave End Only) The 
181 [set pointer (slave erd)] 
22. 35 17 SP Slave issued set pointer - notifies the maste 
22 36 master end job of a SET POINTER command == issued at a 
68 56 ation) file's read/write pointer is used. This cption 
146 _ [slave end issued SET POINTER special] 
181 56 TER, a "Slave-issued set pointer" special is given tot 
146 28 15 (slave end issued SET POINTER) at the master erd of 
188 28 RUNCATE, SCRATCH, or SET POINTER) has been issued at th 
175 29 TE (or SCRATCH), and SET POINTER. This chapter descri 
241 37 d files, moves them into preallocated scratch files, an 
106 20 ation A Catalog MAX or preallocation length N (Load- 
249 11 hanging their MAX's.. PREF An object's preference 
245 24 — 4 ACC PREF TYPE PREF: bits 29-31; -————— 
247 44 DAYS-USED PREF TYPE PREF: bits 29-31; - 
137 43 djustment bits 29-31: preference (see Chapter 9 for 
121 51 ays-used count Lower: preference and type of file/ca 
126 17 atalog is open Lower: preference and type of catalog 
126 46 ays-used count Lower: preference and type of file/ca 
106 33 h/eXecute, and Owner). Preference is an integer betwe 
86 55 11 be created with the preference specified in bits 9 
179 30 nd. In either case, the preference, length, and pointe 
179 18 he other fields (access, preference, length, pointer) a 
246 26 . PREF The catalog's preference. See the discussio 
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249 44 
88 24 


222 37 
38 40 
85 16 
14 41 
14 37 
88 21 

126 40 

52° (32 

156.> 32 

162 32 

lol 36 

157 34 

102, 23k 

100 «655 
59: Si 
48 29 

103 38 

164 13 

157 38 

102 12 
ao ‘32 


38 48 
114 12 
247 22 
223 40 
44 11 
142 23 
42 29 
85 28 
85 30 
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open scratch files with preferences other than 4, orc 
see CATALOG) 29-35 Preferences to allow when crea 
[preference] 
[preference] 
out status. High-Speed Printer The user of the prin 
f scratch files) 5 Priority Scheduling (PDQ) 6 
are Large State Vector, Priority Scheduling, Crash, an 
ob in question is highly privileged (enabled) it may us 
ag, DRL, lockup, illegal procedure (IPR), incomplete op 
ion bits for master trap program (see CATALOG) 29— 
Password or name of trap program (zero if catalog is 
AQ Passed to slave trap program if file is slave trapp 
AQ Passed to slave trap program if file is slave trapp 
AQ Passed to slave trap program if file is slave trapp 
by the Executive trap program if the catalog is sop . 
ned by the master trap program if the catalog is sop 
leg, then any slave trap program is bypassed and all 
whenever the master trap program is run during an open, 
password or slave-trap program name. If the first 
ated the job. On a trap program protecting a catalcged 
was protected by a trap program, the user access bits 
was protected by a trap prcegram, the user access bits 
ted by the master trap program, then all accesses are 
not protected by a trap program, then the password poi 
ecified password or trap program. If bit 18 of the acc 
: [master trap. prcegram] 
{slave trap program] 
[master trap program] 
[master trap program] 
[slave trap program] 
[master trap program] 
[slave trap program] 
[master trap program] 
[slave trap program] 
talog MAXes, enables the PROVIDE DEVICE ADDRESSES comma 
MME 500126: PROVIDE DEVICE ADDRESSES x0 


h object and applying a "PROVIDE DEVICE ADDRESS" MME to 


the file pointer. Card Punch The card punch has the 
MME 500011: PURE x0 File reference numb © 
has the same effect as a PURE command in which X7 is ze 


has previously issued a PURE command, then any MEMORY 
Se | Catalog Quota — + 
_—_—— Scratch Quota Ss 


] [catalog quota = catalog word allotment 
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85 J [scratch quota = scratch word allotment 
81 41 catalog entry. Catalog quota checks are suspended for 
152 50 see Chapter 8. Catalog quota checks are suspended for 
102 [catalog quota checks] 
131 [catalog quota checks] 
LS] [catalog quota checks] 
162 | {catalog quota checks] 
252 14 tations 9.5.1 Catalog quotas A catalog's quotas ar 
253 11 cataloged). 9.5.2 Job quotas To prevent jobs from 
132 36 ucceeds then his scratch quotas are incremented by the 
116 ill MME 500133: READ x0 File reference numb 
22. A 13 R Slave issued read - notifies the master e 
175 41. command and its variants, READ and WRITE, are used to pe 
120 ill MME 500114: READ CATALOG x0 File refere 
96 ll MME 500125: OLD READ CATALCG AND OPEN FILES © 
96 31 MILES command is like the READ CATALOG AND OPEN FILES co 
114 37 obtain them by issuing a READ CATALOG AND OPEN FILES co 
124 121 MME 500127: READ CATALOG AND OPEN FILES 
124 33 entification words The READ CATALCG AND OPEN FILES co 
247 15 #£be gained by applying a READ CATALOG MME to the catalo 
244 38 . can be obtained by the "READ CATALOG" MME. 
74 {read comm file drive] 
74 [read comm file special] 
138 32 in the same manner as a READ command, except that the 
179 52 ave end job had issued a READ command. It may exercise 
179 39 ntially a variant of the READ command. When the slave 
20 41 s the mode. 1 RCF Read communication file - used 
180 27 cation file are: (1) "Read communication file" drive 
195. 43 If job A now issues a "read communication file” drive 
41 21 pausing after issuing a READ on a terminal communicati 
171 45 d issues a corresponding READ or COPY. (See the descri 
69 49 precede the slave issued READ or slave issued WRITE spe 
69 [slave end issued READ special] 
177 [slave issued READ special] 
194 20 ppose job D now issues a READ to file reference number 
177 25 indicating "slave issued READ" (a job requested data tr 
193 52 receives a "slave-issued read" special interrupt. If j 
194 21 ied with a "Slave-issued read" special interrupt. Howev 
116 40 ber ll (slave end issued READ) at the master end. The 
192 18 interrupt (slave-issued read) is generated at job A, s 
69 18 ber ll (slave end issued READ) or 12 (slave erd issued 
193 43 issues another ten-word READ, not specifying the no-tr 
185 11 nication file on a COPY, } , WRITE, or DRIVE commard. 
188 42 py-type operation (COPY, READ, WRITE, or REQUEST STATUS 
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Master end job that a read-type command was issued 
ecial, it should issue a read-type command. (Types of 
hes the slave to issue a READ. By convention the low 
rce (destination) file's read/write pointer is used. T 
nonedit mode. Card Reader The card reader can b 
ve call SET TIMER, and a real-time (elapsed time) timer 
eceive an execute fault (real-time timer runout fault). 
pecial interrupt, or one real-time timer runout fault h 

a simulated status. RECORD COUNT RESIDUE (Bits 30- 

6.6 Executive Error Recovery If Executive error 
e. 1.1.1 Base Address Register The base address re 
d below). 1.1.2 Timer Register The timer register 
ng a pseudo base address register. SQUEEZE causes the 
[BAR = base address register] 
not specified in X4 are relinquished. Any accesses sp 
MME 500130: OLD REPLACE x0 File reference n 
MME 500116: REPLACE xX0 File reference n 
MME 500140: TALLY REPLACE x0 File reference n 
mand is exactly like the REPLACE command, except an x4 
G, TRUNCATE, SCRATCH, or REPLACE type command will ke r 
ACCESSES, DUPLICATE, and REPLACE, gives the access wi 


perations such as ERASE, REPLACE, SCRATCH are not allow 


OPEN, ERASE, CATALOG, or REPLACE. Intended for ccammuni 
or TALLY ERASE and TALLY REPLACE: Bit 4 is the escap 
MME 500006: MEMORY RECUEST X5 Upper memory lim 

the job issues a MEMORY REQUEST call (on a MME fault, 
released with a MEMORY REQUEST command before the tra 
' MME 500115: REQUEST STATUS x0 File refe 

ussed here. 5.2.1 REQUEST STATUS (Master End) 

end job's COPY. 5.2.2 REQUEST STATUS (Slave End) A 
15 FS Slave issued request status - notifies the 
ccomplished by issuing a REQUEST STATUS as the first fi 
peration except CLOSE or REQUEST STATUS can be issued t 


_ his can be verified by a REQUEST STATUS ccmmard), where 


gth (available through a REQUEST STATUS ccmmand) is alw 
y issue DRIVE, CLOSE, or REQUEST STATUS cammands. A RE 
is now idle. 5.6.2 REQUEST STATUS from a Slave En 
PASS command and if the REQUEST STATUS is the first fi 
same end), except that a. REQUEST STATUS issued to the m 
Or an ordinary file (see REQUEST STATUS MME) and should 
Or an ordinary file (see REQUEST STATUS MME). The type 
un below it by issuing a REQUEST STATUS on file referen 

{slave end issued REQUEST STATUS special] 

Master end job that a REQUEST STATUS was issued at 
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179 40 sues it, a "Slave issued 
138 25 ber 13 (slave end issued 
177 53 n the master end (except 
192 16 ts new file by issuing a 
189 50 ued at the master end is 
103 34 be obtained by issuing a 
84. 52 d job can issue a MEMORY 
185 41 not release an existing 
188 50 cation file itself. Any 
187 34 releasing the slave end 
194 39 tion. 5.6.6 Slave End 
228 25 ey are issued unless the 
70 21 ccmmunica-~ tion file, 
185 22 ifying that it wishes to 
189 56 fr erd will not release a 
75 35 mmunication file will be 
141 45 o be released (if it was 
142 13 t case, the file will be 
“117 #20 hared file, that file is 
172 28 or shared file will be 
178 417 en reverts to an idle or 
180 52 ve. If no Slave erd has 
185 45 . £When a slave end has 
180 35 munication file is not 
181 23 le will automatically be 
194 44 ype 0). The file is now 
194 28 0), and the file becomes 
187 24 Second, the file may be 
1g9 25 at the master end can be 
191 12 to an idle (or possibly 
184 {slave end 
184 [master end 
184 35 o longer exists. 5.4 
20 Sl not yet responded. (See 
20. 48. 2 SRS Slave issued 
190 53 received a slave-issued 
188 [slave issued 
ie2; 3) in: Section 5.3. 5.227 
186 24 5.5 Busy States and 
141 11 MME 500135: 
69 32 rt the copy by issuing a 
186 54 ds. The function of the 
185 12 rve the file only with a 
187 32 issued. In either case, 
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word 


request status" 
REQUEST STATUS) 
REQUEST STATUS) 
REQUEST STATUS. 
REQUEST STATUS. The situation 
REQUEST STATUS. These user ac 
REQUEST to change the size of 
reserva- tion. When a slave 
reservation by the slave end i 
reservation. It will not, how 
Reservation; Local Operations 
Reserve bit is set in the flag 
reserve that file. for this end 
reserve the file, then the s 
reserved communication file. F 
reserved for the end issuing 
reserved for that end). The 
reserved for the master erd 
reserved for the end issuing 
reserved for the end issuing 
reserved state, depending on t 
reserved the communication f 
reserved the file, it appears 
reserved to any slave ernd (see 
to that job. 5.2.4 
to the first slave en 
to the master end. [ 
reserved to this slave end, wi 
reserved with a RESET STATUS c 
reserved) state. Finally, wh 
reserve] 

reserve] 

Reserving the File. 
RESET 
reset 
reset 
reset 


special interr 
is generated a 

will be reject 
It therefore 


reserved 
reserved 


It is scm 
STATUS, Section 5.2.) 

- notifies the master 
Special interrupt ard ha 
special] 

RESET STATUS 
Reset Status 
RESET STATUS 
STATUS 
STATUS 
STATUS 
STATUS 


Since several j 
Since many jobs 
XO File refere 
command on the co 
command is always 
cammand. Once t 
functions as a lo 
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190 56 ued to that end before a RESET STATUS is issued. Other 

191 18 ter end is destroyed. A RESET STATUS issued before the 
20 50 slave end jcb issued a RESET STATUS on a COPY to whic 
44 46 #£X7 zero or by issuing a RESET STATUS on the source fil 

184 18 gr for any command except RESET STATUS or CLOSE. Howeve © 

194 25 Job A therefore issues a RESET STATUS requesting the co 

141 [slave end issued RESET STATUS special] 

197 14 up state, job A issues a RESET STATUS to clear cut job 

190 25 S. If issued in time, a RESET STATUS will prevent the 

141 41 er two (slave end issued RESET STATUS) at the master en 

187 39 nd. Local operations are RESET STATUS, PASS, and, if th 

175 28 «=, CLOSE, REQUEST STATUS, RESET STATUS, TRUNCATE (or SCR 
64 42 1 MME's except CLOSE and RESET STATUS. If a suspended 
66 31 The jcb was stopped by a RESET STATUS. The A-register 

188 45 mand, unless it issues a RESET STATUS. The action of a 

228 29 ithout the bit set, or a RESET STATUS. While the file i 
66 [reset status] - 

188 53 interrupt ("Slave issued reset") that its COPY is no lo 

177 52 COPY command, unless it resets status on the master en 

i185. 21 (1) If the master end resets status on the communica 
38 28 eduling only) 1 Core Residence permission 2 Lar 

204 26 status. RECORD COUNT RESIDUE (Bits 30-35) - This fi 
77 34 word 2 contains the DCW residue of the last DCW access 
77 [DCW residue] 

47 #32 pointed to by 4X7, and a RET instruction is executed th 
22 53 lave faults by issuing a RET instruction to the appropr 
17 12 utine should end with an RET instruction whose address 
24 34 squeezed mode, since the RET instruction will not "resq 

225 33 #£4error recovery includes retrying timeout status and al 
43 25 the PAUSE command in the return address. | 
87 14 d passed. (4) If the return bit (bit 2) is set int 

112 23 ch is passed without the return bit (bit 2) set in its 
48 19 b are closed and, if the return bit is set in their acc 
64 25 assigned to it. If the return bit is set in the acces 
55 36 atalog must not have the return bit set in its access w 
87 28 le/cataleg which has the return bit set in its access w 

183 24 nd is passed without the return bit set in the accesses 

163 43 the issuing job with the return bit set. On completio 

132 45 the issuing joo with the return bit set. Upon complet 

194 49 t the slave end with the return bit set. It may not pa 

lll 56 s a scratch file and the return bit was not set in the 

192 39 eak. By not setting the return bit, job B effectively 

192 [return bit] | 
29 17 rd 2. (Length or Counts) Return word IC IR Trap R 
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16 29 d of the trap block (the return word), and its IC is re 
23 22 lustrates the use of the return word. EAX6 TRAP p 
64 [returned closed special] 
21 21 le was passed. 5. RF Returned file - notifies the j 
48 [returned file special] 
64 | {returned file special] 

183 49 ve end is notified by a "returned file" special interru 

197 19 ning. Job D receives a "returned file" special interru 
48 21 pecial interrupt type 5 (returned file) is generated fo 
64 27 cial interrupt number 5 (returned file). If it is a sc 
64 52 cial interrupt number 5 (returned file). The job issuin 
94 31 eed to be zero. Status Returns 0 Successful: th 

221). 21, 6.4 Simulated Status Returns In addition to statu. 

2.0.21: 6.3 Device Status Returns This section describ 
76 {device status returns] 

199 30 . A typical example is "rewind" on a magnetic tape han 
36 24 ssuing job happens to be road- blocked at this time it 
43 22 is zero, the job will be roadblocked and will restart a 
18 29 Otherwise, any pending roadblocks on the job are rele — 
29 20 rnword IC [IR Trap Routine Access (bits 0-8 
17 12 + #£4fourth word. This trap routine should end with an RET 
18 53 f its special handling routine. 1.4.5 Saved Speci 

143 11 MME 500120: RUN The RUN MME is very simi 
38 53 index register X3 on the RUN command are ANDed with the . 

182. 47 it PASS available in the RUN command). A ccmmunication 
21 15 it PASS command in the RUN command. If DATA is nonze 
84 22 allowed xX5 Pointer to run list X6 Trap location X > 
86 22. The remainder of the run list contains a list of fi 
84 35 nd with the files in the run list oven for it. The new 
85 4Q 0 +The run list pointed to by X5 must 
42 41 e supra job in X4 of the RUN or CONTINUE command which 

109 45 rted and the supra job's RUN or CONTINUE command is tra. 

106 49 et by the supra job on a RUN or EXECUTE command). A jo 

178 46 ication files cannot be "run". An attempt to do so wil 

199 51 ile as a parameter for a RUN, ERASE, UNCATALOG, TRUNCAT 
29 35 # £been opened. (3) On RUN, EXECUTE and CCNTINUE, giv 
15 15 lable to a slave job. A run-time timer is set by the E 
45 ll memory. MME 500002:. RUNNING TIME No arguments 
46 17 a job to receive a timer runout fault after a specified 
43 18 , or ore real-time timer runout fault has cccurred. If 
15 22 fault is given. A timer runout fault is returned if th 
36 18 e fault (real-time timer runout fault) after a specifie 
ll 35 11 comnect faults, timer runout faults, and startup and. 
13 (saved special interrupt] 
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107 
136 
144 
149 
167 
169 
172 | 
88 
175 
181 
199 
188 
74 
20 
Lo. 
181 
74 © 
74 
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word 


dling routine. 


1.4.5 Saved Special Interrupts 


bia 


ial interrupt stack, all saved special pairs will be di 


he special interrupt is “saved" (see below), 


ee Section 8.3). 8.2 Scanner 


and the 
Conventions The conv 


in X4, then all special scanning conventions are disal 
in X4, then all. special scanning conventions are disal 
in X4, then all special scanning conventions are disal 


ch files) 


5 Priority Scheduling (PDQ) 


6 Crash ( 


e State Vector, Priority Scheduling, Crash, and Log. T 


d job that a TRUNCATE or SCRATCH 
MME 500110: SCRATCH 

MME 500100: OPEN SCRATCH 

nd permission, the job's scratch 


_ oged) file will have its scratch 


[scratch 
ation, a job's remaining scratch 
CLOSE will also have its scratch 

such as ERASE, REPLACE, SCRATCH 
+ | Scratch 
lLlotment] [scratch 


cement succeeds then his scratch 


~ [seratch 

tch file/catalog has its scratch 
| {[seratch 

[scratch quota = scratch 


eeded). The catalog and scratch 


ned, the job's remaining scratch 


nt 1 Job's remaining scratch 
{scratch 

the operation, the job's scratch 
{scratch 

s a file/catalog has its scratch 


_ {seratch 


file/catalogs (see OPEN SCRATCH) 
| Set STATUS, TRUNCATE (or SCRATCH), and SET POINTER. 7 
, and SET POINTER (Slav 


tive. 5.2.5 TRUNCATE, S 


command was issued a 
XQ File reference n 
X4 File/catalog fla 
(catalcg) word alloure 
(catalog) word allotme 
(slave end) ] i 
and catalog word allot 
and catalog word allot 
are not allowed on spe 
Quota -— 
quota = scratch word a 
quotas are incremented 
word allotment] 
word allotment increme 
word allotment] | 
word allotment] 
word allotments for th 
word allotment is decr 


word allotment 2.°C 
word allotment] 
word allotment is incr 
word allotment] 
word allotment decreme 
word allotment] 


The job file for a 


SE, UNCATALOG, TRUNCATE, SCRATCH, or REPLACE type comma 


- yation (DRIVE, TRUNCATE, SCRATCH, or SET POINTER) has b 


ommanication file are 0 (set cammunication file mede) a 

Mnemonic Use 0 SIM Set mode - used to notify the 

ding special interrupts (set mode ard slave-issued driv 

nd job. In particular, a set mode drive (type 0) orad 

ial] [set mode drive = set mode spec 
[set mode drive] 
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181 : [set mode drive] 
74 {set mede drive = set mode special] 

181 © [set mode special] 

146 11 _MME 500113: SET POINTER x0 File referen 

181 [set pointer (slave end) ] 

181 48 TRUNCATE, SCRATCH, and SET POINTER (Slave End Only) 
22 35 17 SP Slave issued set pointer - notifies the mM 
22 36 he master end job of a SET POINTER ccommand'§§ issued a 

146 [slave end issued SET POINTER special] 

181 55 POINTER, a "slave-issued set pointer" special is given 

146 28 ber 15 (slave end issued SET POINTER) at the master erd 

188 28 HE, TRUNCATE, SCRATCH, or SET POINTER) has been issued a 

175 29 UNCATE (or SCRATCH), and SET POINTER. This chapter de 
46 11 MME 500001: SET TIMER A Time = The SET 
15 15 et by the Executive call SET TIMER, and a real-time (el 

172 26 ve communication file or shared file. In that case, 

158 [shared bit] 

117. 20 ave communication or a shared file, that file is rese 

228 33 involving a file open in shared mode may specify only t 

142 26 ATUS on a file ccened in shared mode will cause the fil 
70 26 ion) file is opened in shared mode, do not allow any 

158 21 ve will open the file in shared mde. If the file isn 

220 {shared mode] 

227 41 must be saved with the 'shared' bit turned on in the u 
15 34 Special Locations The shutdown and connect fault cel 
ll 35 faults, and startup and shutdewn faults. These events 
24 19 y slave fault other than simulated slave faults. The j 

2277 del 6.4 Simulated Status Returns In 
24 14 The Executive will link simultaneous traps and special 
503.11 MME 500010: TIME SINCE BCOTLOAD No arguments 
76 36 us word 2 on a completed single action device drive con 

204 36 kinds of device drives. Single action drives change th 

205 11 End Processor 6.2.1 Single Action Drives A singl 

201 22 3 24 29 30 35 Ona single device action DRIVE com 
74 36 ation file mede) and 12 (single device action). These d 
76 19 es for device files: 12 (single device action) and 24 ( 

199° 28 ith function code of 12 (single device action) or 24 (d 
22 32 SCRATCH). (See TRUNCATE-slave end only, Section 5.2. 

192 32 able. 5.6.3 PASS at a Slave End Supoose now that u 

192 11 2 REQUEST STATUS from a Slave End Upon receipt of th 
74 #48 «; (1) At the lowest slave end accepting special in 

175 49 the master end. 5.1.1 Slave End COPY Commands AC 

185 45 reserva- tion. When a slave end has reserved the fil 
20 37 mde i drive (see DRIVE-slave end in Section 5.2). 
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117 «(14 
69 
69 18 


35. 


6 40 
138 
138 24 
141 
141 41 
146 
146. 27 
144 
144 26 
167 
167 30 
69 
69 19 
phy ak 
£71. 42 
69: 25 
69 17 
116: 39 
137: 32 
133: "23 
144 25 
146 26 
167 29 
Lik, 4 
75 «44 
87 12 
194. 39 
184 
187 15 
64 35 
L72: 22 
141 37 
L793 
181 27 
181 
181 
181 
ek ee 
21 54 
112. 24 
175 24 
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word 


the corresponding slave 
{slave 
(slave 
(slave 
(slave 
(slave 
[slave 
(slave 
{slave 
(slave 
{slave 
(slave 
[slave 
(slave 
{slave 
(slave 
| [slave 
ial interrupt number 12 (slave 
end has reserved it, the slave 
ed. A COPY issued at a slave 
. A READ issued at the slave 
ber of a job file or the slave 
reference number of the slave 

CH command issued at the slave 
issued at the slave 
issued at the slave 
issued at the slave 
ich may be issued on the slave 
will be created and its slave 
ts reservation. 5.6.6 Slave 
(slave 

to a slave end. 5.5.1 Slave 
file is closed, or if a slave 

case, the corresponding slave 


ile, 


ial interrupt number 11 
ial interrupt number 11 
S special] 

ial interrupt number 13 
special] 

al interrupt number two 
pecial] | 

ial interrupt number 15 
ial] 

ial interrupt number 14 
ial] 

ial interrupt number 14 
] 


end issued READ) or 12 


at both the master ard a slave 
5.2.2 REQUEST STATUS (Slave 
hat job. 5.2.4 DRIVE (Slave 
[truncate (slave 

{scratch (slave 

{set pointer (slave 

cation file and pass its slave 


nd (MODE). (See DRIVE-slave 
- With the exception of slave 
ster end and one or more slave 


end 


end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 
end 


‘end 


end 
end 
end 
end 
end 
end 
End 
end 
End 
end 
end 
end 


End) 
End) 


is trapped only if a 
issued READ special] 
issued READ) or 12 ( 
issued READ) at the 
issued REQUEST STATU 
issued REQUEST STATU 
issued RESET STATUS 
issued RESET STATUS) 
issued SET POINTER s 
issued SET POINTER) 
issued TRUNCATE spec 
issued TRUNCATE) at 
issued TRUNCATE spec 
issued TRUNCATE) at 
issued WRITE special 
issued WRITE) at the 
issued WRITE special 
issued WRITE) at the 
issuing the COPY ccm 
of a communication 
of a communication 
of a communication 
of a communication 
of a communication 
of a communication 
of a communication 
cf a communication 
of a terminal ccmmun 
passed. (4) Ift 
Reservation; Local 0 
reserve] 

States First, the 
to which the ccammuni 
will be trapped oon 
will cause status to 
A REQUEST STATUS 
Certain drive typ 


bh Fh Fh Ph Fh Fh Fh rh 


end) ] 
end) ] 
end) J 


end, 
end. 


depending on whethe 
) 13 R Slave i 


ends of cammunication fi 


ends. 


Each end appears 
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24 19 pt) if any, and then any slave fault other than simulat 
22 49 p, special interrupt, or slave fault to be given toa j 
13. 21 Executive call. 1.3 Slave Fault Vector The first 
15 35 have special uses in the slave fault vector. Word 0 (t 
24 29 p, special interrupt, or slave fault, it is unsqueezed. 
14 15 slave faults. To give a slave fault, the Executive sto 
24 19 ult other than simulated slave faults. The job will th 
13 29 hile others are used for slave faults. The position of 
21 50 or future use. 12 D Slave issued drive - notifies 
22 ll E-slave end.) 13 R Slave issued read - notifies t 
177 . [Slave issued READ special] 
177° 25 al interrupt indicating "slave issued READ" (a job requ 
22 23 Section 5.1.) - 15 RS Slave issued request status - 
179. 40 ve end job issues it, a “slave issued request status” s 
20 48 Section 5.2.) 2 SRS Slave issued reset - notifies 
188 {slave issued reset special] 
188 53 by a special interrupt ("slave issued reset") that its 
22. 30° Section 5.2.) 17 =#«+SP Slave issued set pointer - not 
22. 17° Section: 5.1.) 14 W Slave issued write - notifies 
177 28 larly, in response to a "slave issued WRITE" special, i 
14 29 terminating the aborted slave job. This feature is in 
10 16 tail. 1.1 Running in Slave Mede A job actually ru 
9 23 ontrol of a processor in slave mede and may vcerform any 
14 46 struction is executed in slave mede. MME faults norma 
81 31 then 1 is assumed) AQ Slave trap identification word 
94 22 X6 Trap location AQ Slave trap identification word — 
96 28 of words N to copy AQ Slave trap identification word 
97 24 X6 Trap location AQ Slave trap identification word 
100 28 £f£ bit 4 of X4 is 1) AQ Slave trap identification word 
124 30 of words N to copy AQ Slave trap identification word 
131 30 then 1 is assumed) AQ Slave trap identification word 
152 32 be zero) AQ Passed to slave trap program if file is 
156 32 be zero) AQ Passed to slave trap program if file is 
162 32 be zero) AQ Passed to slave trap program if file is. 
102 31 N-1)st catalog, then any slave trap program is bypassed 
101 [slave trap program] 
132 [slave trap program] 
158 {slave trap program] 
163 {slave trap program] 
127 20 ile/catalog is master or slave trapped, then the acce 
157 41 rrent file/catalog. Slave trapping programs are ru 
131 [slave-issued drive special] 
181 35 interrupts (set mede and slave-issued drive) at the job 
193 52 ords. Job A receives a "slave-issued read" special int 
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194. 21 oA is notified with a "slave-issued read" special int | 
192 18 s. A special interrupt (slave-issued read) is generate 
190 53 r end job has received a slave-issued reset special int 
181 55 issues a SET POINTER, a "slave-issued set pointer” spec 
181 54 ATE to the slave end, a “slave~issued truncate” special 
182 11 a slave end generates a "slave-issued truncate” special 
193 33 1 for twenty words. A "slave-issued write" special in 
59 Sl me the new password or slave-trap program name. Ift 
152 22 £4be zero, (bit 4) escape special convention, (bits 9- 
162 22 £be zero, (bit 4) escape special convention, (bits 9- 
186 16 ak permission, the break special "bounces" up the commu 
197 20 lowed by a "file closed" special as its file reference 
38 33 ore than 64 files) 3 Special Catalog permission (al 
108 43 ob is enabled with the Special Catalceg permission and 
199 25 es are always of type 6 (special cataloged file). They 
251 16 Peripherals are saved as special cataloged files, since 
156 23 ap bit mask and escape special convention bit X5 Po 
232 48 #£=8.3). There are three special conventions for the fi 
230 34 when one of the three special conventions is used fo 
229 40 (2) There are several "special conventions" which al 
232 [special first name = special convention] 
232 onvention] [special first name = special c 
148 43 #£the treename contains a special first name. The name 
152 44 #4the treename contains a special first name. For more 
156 52 £the treename contains a special first name. For more 
162 49 the treename contains a special first name. The name 
18 53 O until the emd of its special handling routine. ee 
183 49 ied by a "returned file" special interrupt (if it is ac 
183 11 e end ina “passed file” special interrupt (see types o 
190 54 ved a slave-issued reset special interrupt and has not 
197 19 ceives a "returned file" special interrupt due to the c 
18 19 irst opportunity after a special interrupt is generated 
179 40 e issued request status" special interrupt is generated 
180 19 nd job issues a DRIVE, a special interrupt is generated 
193 34 A "slave-issued write” special interrupt is generated 
lil 31 fied in X0, generating a special interrupt number 4 (pa 
47 34 R. Ifa fault, trap, or special interrupt cccurs while 
17 56 #£interrupt data entries (special interrupt pairs) which 
18 41 £special interrupt data (special interrupt pair) are | 
19 19 saved. However, once a special interrupt pair has bee 
19 35 in Section 5.2. 1.4.7 Svcecial Interrupt Pair Format 
192 42 C receives a passed file special interrupt specifying i 
17 46 Illy pointer to the job's special interrupt stack. The 
18 42 air) are stored in the special interrupt stack. The 
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interrupt tally word. 

interrupt tally word ( 
interrupt tally word - 
interrupt to the lowes 
interrupt was generate 
interrupt which occurr 


interrupt) 
interrupt, 
interrupt, 
interrupt, 
interrupt, 
interrupt, 
interrupt. 


interrupt. 


interrupt. 
Interrupts 
Interrupts 
Interrupts 
Interrupts 
interrupts 
interrupts 
interrupts 
interrupts 


interrupts. 


interrupts 


interrupts. 


interrupt] 
interrupt] 


if any, and 
it must eve 
or slave fa 
or slave fa 
or one real 
suppose job 
If jobAt 
However, jo 
The file is 


(set mode a 
are describ 
at the mast 
is also aft 
that the co. 

Leen: oe 


is generated. When the 
is given to a slave en 
is given to the master 


pairs will 


be discarde 


scanning conventions a 
scanning conventions a 
scanning conventions a 


specifying 


a length of 


special, it should issue a rea 
specially-cataloged catalog. T 
specials in such a way that a 


page line word 
15 38 fault cell) is the jeb's special 
17 34 1 interrupts only if its special 
177 (18 (have a valid, nonzero, special 
196 16 ive attempts to give the special 
25 53 unless a fault, trap, or special 
17 23 #£before encountering any special 
24 18 #£x°+then the connect fault (special 
177 50 end job has received the special 
22 48 for more than one trap, special 
24 29 pter 3) receives a trap, special 
43 18 ocked until N traps, one special 
192 14 ipt of the “passed file” special 
193 52 esa "slave-issued read" special 
194 21 tha “slave-issued read" special 
191 51 is 7) in a “passed file" special 
17 29 ey were issued. 1.4.2 Special 
19 lil routine. -1.4.5 Saved Special 
19. 26 arded. 1.4.6 Bouncing Special 
20 30 below. 1.4.8 Types of Special 
177 18 #£=°master end be accepting special 
181 34 nerate the corresponding special 
15 40 special interrupt cell. Special 
181 52 ve end and will generate special 
185 .53 nd job. The routing of special 
184 16 notified by file-closed special 
16. 15. e Job BY using traps and special 
18 {bounced special 
18. [saved special 
181 54 =‘"slave-issued truncate” special 
185 25 fied. (2) If a break special 
181 56 lave—-issued set pointer" special 
19. 22 terrupt stack, all saved special 
152 42 ) is set in X4, then all special 
156 50 ) is set in X4, then all special 
162 47 ) is set in X4, then all special 
182 11 "slave-issued truncate" special 
177 28 oa "Slave issued WRITE" 
251 11 ent, the MFD is the only 
24 14 &k simultaneous traps and 
48° {returned file special] 
64 [returned file special] 
64 {returned closed srecial] 
64 [special] 
69 [slave end issued READ special] 
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69 
74 
74 
74 

138 

141 

144 

146 

167 

171 

177 

177 

181 

181 

186 

188 

194 
47 
24 
25 
24 
14 
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[slave end issued WRITE 


et mode drive = set mede 
{read comm file 
(break 


nd issued REQUEST STATUS 
end issued RESET STATUS 
lave end issued TRUNCATE 
e end issued SET POINTER 
lave end issued TRUNCATE 
[slave end issued WRITE 
[Slave issued READ 
[bouncing 
[set mede 
[slave-issued drive 
{bouncing 
[slave issued reset 
[bouncing 

MME 500007: 
BAR, and has. bit 35 (the 
Except in the case of a 
ng in squeezed mede (see 
generating the MME is in 
_ When a job running in 
calls. . If a job is in 
in the special interrupt 


_ jeb's special interrupt 


. These operations use a 


word 


special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] 
special] | 
SQUEEZE X4 Points to IC/IR 
squeeze bit) set on to indicat 
SQUEEZE or a TERMINATE command 
SQUEEZE, MME 500007 in Chapter 
squeezed mede (entered by the 
squeezed mede (see SQUEEZE, MM 
squeezed mede, or if the addre 
stack. The address field of 
stack. The tally word is typi 
standard treename format (defi 


[s 


[slave e 
[slave 


5 Busy States and Reset Status 


ile system (denoted by a standard treename). The TALL 
[standard treename] 

[standard treename] . 

[standard treename] 

timer runout faults, and startup and shutdown faults. 
ved for future use. The startup fault cell is not used 
@ permission 2 Large State Vector permission (permi 
-it is enabled are Large State Vector, Priority Schedul 
Ss to an idle or reserved state, depending on the option 


end. 5.5.1 Slave End States First, the file and t 
ain. 5.5.2 Master End States The situation is comp 
led astray. 5.5 Busy States and Reset Status Sinc 


Since many jobs may a 


tion 5.3. 5.2.7 RESET STATUS Since several jobs ca 
MME 500115: REQUEST STATUS XO File reference nu 
MME 500135: RESET STATUS XO File reference nu 


camminication file busy” status (6) is a special status 
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35 


z3 
42 
55 
34 
54 
33 
51 
Ls 
12 


i ee 
a2 
56 
29 
18 
40 
16 
50 
48 
21 


46 


25 
il 
ai 


24 
25 
37 


41 
25 
53 
39 
SP 
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43 
aed : 


20. 


35: 


“32 
19), 


15. 


line 


is powered off. 
re. 5.2.1 REQUEST 
s COPY. 5.2.2 REQUEST 
ven in octal. The Minor 
RS Slave issued request 


hed by issuing a REQUEST 


except CLOSE or REQUEST 
us word always contain a 
he function of the RESET 
copy by issuing a RESET 
ilable through a REQUEST 
be verified by a REQUEST 
e file only with a RESET 
DRIVE, CLOSE, or REQUEST 
idle. 5.6.2 REQUEST 
- In either case, RESET 
that end before a RESET 
mmand and if the REQUEST 
d is destroyed. A RESET 
), except that a REQUEST 


dinary file (see REQUEST 


end job issued a RESET 
it by issuing a REQUEST 


‘T£ the master end resets 


ommand, unless it resets 
ro or by issuing a RESET 
any command except RESET 
therefore issues a RESET 
6.4 Simulated 
6.3 Device 
{device 
slave end issued RECUEST 
[slave end issued RESET 
te, job A issues a RESET 
r end job that a REQUEST 
issued in time, a RESET 
e description of the two 
{device 
a "slave issued request 
(slave end issued RESET 
slave end issued REQUEST 
ster end (except REQUEST 
cal operations are RESET 
responded. (See RESET 


word 


MAJOR STATUS 


STATUS 
STATUS 
Status 
status 
STATUS 
STATUS 
status 
STATUS 
STATUS 
STATUS 
STATUS 


STATUS ) 
STATUS , 
STATUS , 


on 


(Bits 2-5) -— This field 
(Master End) A REQUES 
(Slave End) A REQUEST 
(Substatus) is six bits 


~- notifies the master 
as the first file opera 
can be issued to that e 
code indicating whether 
command is always to fo 
command on the ccommunic 
command) is always zero 
command), whereas the 1 
command. Once the fil 
commands. A RESET STAT 
from a Slave End Upon 
functions as a local op 
is issued. Other coma 
is the first file opera 
issued before the CLOSE 
issued to the master en. 
MME). The type field o 
on a COPY to which the 
file reference numbe 
on the communication 
on the master end (see 
on the source file for 
or CLOSE. However, the 
requesting the ccmmunic 
Returns In addition t 
Returns This section 
returns] 
special] C. 
special] : 
to clear out job D's RE 
was issued at a slave 
will prevent the specia 
words is given in Secti 
word] 
special interrupt is g 
at the master end and 
is generated at the ma 
will be rejected as "i 


PASS, and, if the end 
Section 5.2.) 3 BR 
Pub.1059 
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line 


VE commands. 
sferred). 6-11 Minor 
mally on). 1-5 Major 
ains the physical device 
S except CLOSE and RESET 
b was stopped by a RESET 
ile by issuing a REQUEST 
unless it issues a RESET 
he master end is REQUEST 
ned by issuing a REQUEST 

the bit set, or a RESET 

{reset 
= minor 

{minor 


The Major 


{substatus 


dirty fault vector. The 
ed on a running job will 
y cause the Executive to 
rred because the jcb was 
and whose execution was 
is always zero, while a 


and for a description of 
le reference number of a 


job aborted, the job is 
aborted; that is, it is 
tion of the slave job.is 
Whenever a memory, fault 

MME 500141: 
(3) For 

MME? 500137: 
(lL) For 

MME 500136: 
ified file is made using 
Aprend permissions using 
file in shared mode, see 


t mask. 


ree formats: 


on the file/catalog using 


(2). Bor 


MME 500140: 
For TALLY ERASE and 


e@ operation. 


(1) 


if its special interrupt 


nzero, special interrupt 
job's special interrupt 
e last card.) Magnetic 


word 


Status, which is four bits, nu 
status. 12-17 Queue addres 
status. 30-35 Record count 
status. Status Returns 0 
STATUS. If a suspended job f 
The A-register will 
It therefore issues o 
The action of a RESET 
The situation is simi 
These user access bit 
. While the file is rese 
status] 
status] 
status] 


[substatus-= minor status] 


supra job then has the option 

suspend execution of that job 

Suspend the job. Executive en 
suspended (for the reasons lis 
suspended as a result of the s 
suspended job never has zero l 
suspended jobs). All files op 
suspended or terminated job fi 
suspended, and its execution m 
suspended, and the job which r 
suspended; (2) Two words o 
tag, DRL, lockup, illegal proc 
TALLY CATALOG x0 File refer 
TALLY CATALCG: The register 
TALLY ERASE XO File referen 
TALLY ERASE and TALLY REPLACE: 
TALLY OPEN XO File referenc 
TALLY OPEN (MME 500136). The 

TALLY OPEN (MME 500136). If t 
TALLY OPEN. A file which is 

TALLY OPEN. If Read, Write, a 
TALLY OPEN: Bits 0-3, 5-8 a 


[TALLY OPEN] 


TALLY REPLACE x0 File refer 
TALLY REPLACE: Bit 4 is the 
tally word (word one) is not z 
tally word — see Section 1.3) 
tally word. The connect fault 

Tape Handler Note that it is 
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word - 


tape is retried with backspace 
terminal cammunication file. 
terminal communication file, t 
terminal communication files i 
TERMINATE xX4 Termination ac. 
TERMINATE command, a slave job 
TERMINATE command.) If a ter 
terminated (see the descriptio 
terminated infra jobs. If x0 
terminated job file can always 
terminated job file, then the 
terminated, either successfull 
terminated, however, another C 
terminates or aborts. Status w 
terminates or is aborted. ce 
terminating the aborted slave 
termination of the spawned job 
TIME. No arguments The tota 
TIME No arguments The tota © 
TIME OF DAY No arguments T 
TIME SINCE BOOTLOAD No argum . 


e an execute fault (real-time timer runout fault) after 
1 interrupt, or one real-time timer runout fault has oe 


page line 
225 44 ried. A data alert on 
75 44 ed oon the slave end of a 
180 47 typical use is with a 
181 40 communication file. For 
48 ll. MME 500000: 
25 51 e case of a SQUEEZE or a 
65 12 e the description of the 
64 46 nd all jobs below it are 
137 28 esources consumed by all 
88 49 CLOSE. (See CLOSE.) A 
136 54 number of a suspended or 
88 41 d. If, however, the job 
66 56 NUE command. If the job 
66 49 ob file, or when the job 
88 34 the job file, or.the job 
14 29 option of continuing or 
86 17 #14xthe spawning job. Upon 
40 ll MME 500012: JCB 
45 11 MME 500002: RUNNING 
49 ll MME 500003: 
50 ll MME 500010: 
36 18 
43 18 
46 11 MMB 500001: SET 
15 15 a slave job. A run-time 
15 16 real-time (elapsed time) 
10 36 scribed below). 1.1.2 
46 #417 ables a job to receive a 
43 18 errupt, or one real-time 
15 22 slave fault is given. A 
36 18 execute fault (real-time 
11 35 are all connect faults, 
15 15 y the Executive call SET 
15 14 Two software-simulated 
36 | 
46 
Uh 27. @faule cceurs. . «1.2.2 
157 33 e returned by the master 
12 42 he action is complete, a 
12 41 ping call must specify a 
16 23 or invalid parameter. A 
152. 23 convention, (bits 9-17) 
162 23 convention, (bits 9-17) 
81 23 st be zero (bits 9-17) 
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TIMER 
timer 
timer 
Timer 
timer 
timer 
timer 


A Time The SET TIME 
is set by the Executive 
is set by the Executive 
Register The timer reg 
runout fault after a spe 
runout fault has cccurre 
runout fault is returned 
timer runout fault) after a sp 
timer runout faults, and start 
TIMER, and a real-time (elapse 
timers are available to a slav 


{timer ] 
[timer] 


Transparent Interrupts Certa 
trap program if the catalog 
trap (described in Section 1.4 
trap address in X6 at the time 
trap address is specified when 
trap bit mask X5 Pointer to 
trap bit mask xX5 Pointer to 
trap bit mask xX5 Reserved fo 
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page line word 
131 22 ust be zero; (bits 9-17) trap bit mask X5 Reserved fo 
124 22 ess for OPEN (bits 0-8); Trap bit mask (bits 9-17) X5 
156 22 ed accesses on the file, trap bit mask and escape spe 
148 38 OPEN (MME 500136). The trap bit mask for the search i 
LOL 11 b will be limited by the trap bit mask in bits 9-17 of 
230 43 ow). Bits 9-17 are the trap bit mask to be used durin 
60 ll . If this word contains trap bits which the issuing 
81 31 1 is assumed) AQ Slave trap identification words Th 
94 22 Trap location AQ Slave trap identification words Th 
96 28 rds N to copy AQ Slave trap identification words Th 
97 24 Trap location AQ Slave trap identification words Th 
100 28 4 of x4 is 1) AQ Slave trap identification words Th 
124 30 rds N to copy AQ Slave trap identification words Th 
131 30 1 is assumed) AQ Slave trap identification words Th 
193 29 .4 COPY Command with No-Trap Option Job D now issues 
194 12 ™" (2). Note that the no-trap option had no effect, sin 
193 40 (job A) specified the no-trap option. Suprose jobAn 
88 21 rmission bits for master trap program (see CATALCG) 
126 40 2-3 Password or name of trap program (zero if catalog 
152 32 ro) AQ Passed to slave trap program if file is slave 
156 32 ro) AQ Passed to slave trap program if file is slave 
162 32 ro) AQ Passed to slave trap program if file is slave 
101 36 urned by the Executive trap program if the catalog is 
102 31 # catalog, then any slave trap pregram is bypassed ard 
100 55 that whenever the master trap program is run during an 
59 Sl new  vassword or slave-trap pregram name. If the fir 
48 29 initiated the job. On a trap program protecting a cata 
103 38 if it was protected by a trap program, the user access 
164 13 if it was protected by a trap program, the user access 
157 38 rotected by the master trap program, then all accesse 
102 12 og is not protected by a trap program, then the passwor 
55 32 he specified password or trap program. If bit 18 of th 
101 {master trap program] 
101 [slave trap program] 
102 [master trap program] 
132 {master trap program] 
132 [slave trap program] 
158 {master trap pregram] 
158 [slave trap program] 
163 [master trap program] 
163 [slave trap program] 
29 20 #£Return word IC [IR Trap Routine Access (bits 
17 12. n the fourth word. This trap routine should end with a 
178 ll issued. 5.1.3 The "No-Trap” Option When the master 
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page line word 

176 47 nd job exercises the "no-trap" option — see below). T 
25 53 truction unless a fault, trap, or special interrupt was 
47 34 fied IC/IR. If a fault, trap, or special interrupt occ 
22 48 ssible for more than one trap, special interrupt, or sl 
24 29 in Chapter 3) receives a trap, special interrupt, or sl 

102 27 # successfully run master trap, then all requested acc 
23 17 doso. 1.4.10. Typical Trap-Handling Code (Non-Multip 

127. 20 talog is master or slave trapped, then the access bit 
12 38 transparent interrupt. Trapping calls also function a 

157 41 file/catalog. | Slave trapping programs are run only 
12 28 hree types: nontrapping, trapping, and trapping with au 
9 46 truction that. faulted traps indicating that asynchr 
16 15 h the slave job by using traps and special interrupts.. 
24 14 e will link simultaneous traps and specials in such a w 
17 23 will also encounter all traps before encountering any 
43 17 0o be roadblocked until N traps, one special interrupt, 
81 29 X7 Number of entries in treename (if zero, then 1 is a 

131 28 X7 Number of entries in treename (if zero, then lisa 

233 45 s. Any attempt to use a treename consisting of more th 

231 46 er are the following: A treename consists of one or mo 

229 47 perations use a standard treename format (defined in Se 

157 18 ucceeding catalog in the treename is found, it is searc 

229 37 (1) The format of a treename is very inflexible, a 

156 41 is a tally word for the treename of the file to be ope 

100 32 #£=filenames which form a "treename”) is located in the £ 

162 36 m (denoted by a standard treename). The TALLY REPLACE 

148 34 og denoted by a standard treename. First an attempt t 

148 {standard treename] 

152 [standard treename] 

153 [treename] 

156 [standard treename] 

162 [treename] 

233 [treename] 

167 ll estroyed. MME 500107: TRUNCATE x0 File reference 

175 28 ST STATUS, RESET STATUS, TRUNCATE (or SCRATCH), and SET 

181 [truncate (slave end)] © 

144 45 as a special case of the TRUNCATE cammand in which the 
22 29 master end job that a TRUNCATE or SCRATCH = cammand 

144 [slave end issued TRUNCATE special] 

167 | {slave end issued TRUNCATE special] 

181 54 ave end, a "slave-issued truncate” special is generated 

182 11 enerates a "Slave-issued truncate" special specifying a 

144 27 ber 14 (slave end issued TRUNCATE) at the master end. 

167 31 
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144 28 
14 38 
181 48 
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word 


errupt will be zero (see TRUNCATE). If the ccmmunicati 
plete op (ONC), overflow/truncate, or divide check faul 
the Executive. 5.2.5 TRUNCATE, SCRATCH, and SET POI 
e-type operation (DRIVE, TRUNCATE, SCRATCH, or SET POIN 
a RON, ERASE, UNCATALOG, TRUNCATE, SCRATCH, or REPLACE 
to source file xX3 Job type (bits 0-8) X4 Maximum a 
Meaning 0 Accesses/Type (see below) 1 Job len 
ferences) bits 32-35: type (see Chapter 9 for types) 
3 are ANDed with the job type bits allowed to the job i 
hanged to a special file type called a "non-file” (13), 
of the trap. - On a copy-type command which involves de 
EQUEST STATUS MME). The type field of the status block 
information or is zero. Type information has the follo 
the lower half contains type information or is zero. 
set (bits 0-8) The job type of a running job consists. 
Lower: preference ard type of catalog 5 Upper: 
Lower: preference and type of file/catalog 6 Upp 
Lower: preference and type of file/catalog 6 Upp 
ence 0. An object's type to a large extent determi 
ors. TYPE The file's type. Described below for fil 
—_—— ee - )SCOTYPE:)«ibits 32-35 5 ENTRIES 
_—— TYPE: bits 32-35 6 DLU DL 
to determine peripheral types, etc., most jobs may not 
t-ready drive. Console Typewriter Note that unlike 
| {file type] | 
MME 500104: UNCATAITCG x0 File reference 
quence of cammands OPEN, UNCATALOG, and CLCSE. Uronc 


‘ameter for a RUN, ERASE, UNCATALOG, TRUNCATE, SCRATCH, 


command (q.v.). Lower: Unique Identifier. This field 
st point to two words of usage and dates information. 
words contain the new usage information for the file 
5 points to two words of usage information to be placed 
per: ccded date of last use Lower: ccded date of la 
per: ceded date of last use Lower: ceded date of la 
sting discussion. DAYS-USED The DAYS-USED field con 
ed in X6. The date last used and date last modified in 
zero, and the date-last-used and date-last-medified ar 
ize the file's Date Last Used attribute. The lower hal 
word 5 Upper: days-used count Lower: preferenc 
word 5 Upper: days-used count Lower: preferenc 
d to set the file's days-used count; the lower half con 


d to set the file's days-used counter (see Chapter 9). 


ntains a coded Date Last Used in the upper half and ccd 


ds. The two high-order user access bits (bits 9 and 1 
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163 56 a REQUEST STATUS. These user access bits are obtained 
163 56 a REQUEST STATUS. These user access bits are obtained 
103. 34 word 1 of the trap, nine user access bits can be obtain 
132 22 word 1 of the trap, nine user access bits can be obtain 
158 36 word 1 of the trap, nine user access bits can be obtain 
163 55 word 1 of the trap, nine user access bits can be obtain 
127 54 k. In addition, the nine user access bits from 9-17 of 
233 19 ("*"), and is a legal user number format the scanner 


121 [DLU = date of last use] 

b3*; 24) als 1.3 Slave Fault Vector The first 40 (octal) 
18 48 s place. No dirty fault vector aborts are generated. 
38 30 ission 2 Large State Vector permission (permits as 


14 26 e job had a "dirty fault vector” and is aborted; that i 
85 15 enabled are Large State Vector, Priority Scheduling, C 
15 25 borted for a dirty fault vector. The simulated faults 
15 35 uses in the slave fault vector. Word 0 (the first wor 
128 29 date, and the lower half-word contains the reel numbe 
136 35 Job's remaining catalog word allotment 1 Job's rem 
136 37 £Jcb's remaining scratch word allotment 2 CRU limit 
132 34 og first has its catalog word allotment decremented by 
163 31 og first has its catalcg word allotment decremented by 
169 28 /catalog has its scratch word allotment decremented by © 
56 38 /cataleg has its scratch word allotment incremented by 
144 40 ve its scratch (catalog) word allotment incremented by 
153 17 nd will have its catalog word allotment incremented by 
56 39 he same time its catalog word allotment is decremented 
70 52 Job's scratch (catalog) word allotment is decremented 
107 35 job's remaining scratch word allotment is decremented 
149 27 header, and its catalog word allotment is decremented 
149 25 ation, the job's scratch word allotment is incremented 
169 29 he same time its catalog word allotment is incremented 
48 22 ning scratch and catalog word allotments are added to t 
86 15 The catalog and scratch word allotments for the spawne 
64 54 its scratch and catalog word allotments incremented by 


48 {seratch word allotment] : 
70 {catalog word allotment] 

70 {scratch word allotment] 

85 [catalog quota = catalog word allotment] 

a5: « {[seratch quota = scratch word allotment] 

144 [scratch word allotment] 

144 [catalog word allotment] 

167 [scratch word allotment] 

167 [catalog word allotment] 
172 [scratch word allotment] 
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172 
16: 29 
23 22 
16 37 
200 
172. Ad 
22 17 
179." SL 
193°. 33 
138 29 
68 56 
69 
171 
192.21 
193: «33 
177.28 
69 19 
171 42 
177 26 
175 41 
185) ed 
188 42 
22. 18 
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word 


{catalog word allotment] 


e trap block (the return word), 
es the use of the return word. 
iption of the two status words 
(device status word] 
MME 500134: WRITE 
) 14 W Slave issued write 
formation with a COPY or WRITE 
Tf job A then issues a WRITE 
n to the slave end via a WRITE 
destination) file's read/write 
{slave end issued WRITE 
[slave end issued WRITE 
t.) Job A then issues a WRITE 
words. A "slave-issued write” 
ponse to a "slave issued WRITE" 
or 12 (slave end issued WRITE) 
ber 12 (slave end issued WRITE) 
should issue a CCPY (or WRITE) 
d its variants, READ and WRITE, 
on file on a COPY, READ, WRITE, 
@ cperation (COPY, READ, WRITE, 


and its IC is reset to 
EAX6 TRAP point to 
is given in Section 2.3. 


Xl Points to pointer 
- notifies the master 
command, exactly as if t 
for ten words, specifyin 
or COPY command. In oth 
pointer is used. This o 
special] 
special] 
to file reference number 
special interrupt is ge 
special, it should issu 
at the master end. The 
at the master end. The 
command transferring da 
are used to perform the 
or DRIVE command. The 
or REQUEST STATUS) issu 


master end jod that a write-type command was issue 
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Section 1.2 


Control and Non-Control Executive 


Multiple Processor Support 


fo) In single processor configurations, the CPU executes both 
the Control and Non-Control EXEC. 


fe) If there are master mode tasks, the Control EXEC is 
executed. If not, the Non-Control EXEC is executed (next 
slave job is run). 


fe) In multiple processor configurations, one CPU is designated 
the Master CPU. All others are Slave CPUs. 


fe) The Master CPU operates as in single processor 
configurations,-executing the Control or Non-Control EXEC 


when appropriate. 


0 Slave CPUs only execute the Non-Control EXEC. 


fo) The Master CPU provides almost all master mode services. 
Note that I/O operations are handled only by the Master CPU. 


° The Control and Non-Control EXEC communicate through the Run 
Queue and Job Service Queue. The Control EXEC places jobs 
to be run by the Non-Control EXEC on the Run Queue. The 
Non-Control EXEC places jobs which require Control EXEC 
processing on the Job Service Queue. 


fo) Access:to both queues is serialized by a semaphore. This 
allows asynchronous access by multiple, independent CPUs. 


fe) Since the Non-Control EXEC is re-entrant, it can be executed 


simultaneously by multiple CPUs. 
_ 
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